● BAYİ API'Sİ · v1

Bayi API Belgesi

Ürünleri, stoğu ve fiyatları çekin; kendi yazılımınızdan ya da SMM panelinizden otomatik satın alın. Fiyatlar, stok ve kurallar sitedekiyle birebir aynıdır; ödemeler bakiyenizden düşer.

Başlangıç

Üye olun ve bakiye yükleyin. Başvuru şartı: bakiyenizin en az 10 USD olması. Bakiye bloke edilmez, alışverişte kullanmaya devam edersiniz.
Hesabım → API sekmesinden başvurun. Onay genelde 24 saat içinde gelir.
Onaydan sonra aynı sekmeden anahtar oluşturun (en fazla 5). Anahtar sadece bir kez gösterilir; güvenli bir yere kaydedin.

Temel adres: https://projelikmail.com/api/v1 · Para birimi: USD

Kimlik doğrulama

Her istekte anahtarınızı X-API-Key başlığında gönderin. Anahtarlar kom_ ile başlar.

curl https://projelikmail.com/api/v1/user/balance \
  -H "X-API-Key: kom_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Anahtarı tarayıcıda/istemci tarafında kullanmayın, sadece sunucunuzdan çağırın. Sızdığından şüphelenirseniz Hesabım → API'den silip yenisini oluşturun.

Cevap biçimi

Her cevapta success bulunur. Başarılıysa veri data içindedir; hatada makine okunur error_code ve açıklama message döner. Karar verirken message metnine değil error_code'a bakın. Para değerleri iki haneli metindir ("1.50").

{ "success": true, "data": { ... }, "meta": { ... } }
{ "success": false, "error_code": "insufficient_balance", "message": "..." }

GET/api/v1/user/balance

{ "success": true, "data": { "balance": "125.40", "currency": "USD" } }

Ürünler

GET/api/v1/products

PARAMETRE	AÇIKLAMA
`category`	İsteğe bağlı: `gmail` · `hotmail` · `outlook` · `other`
`in_stock`	`1` ise sadece satın alınabilir ürünler
`page`	Sayfa (50'şer ürün)

{
  "success": true,
  "data": [
    {
      "id": 421, "category": "gmail", "title": "...", "description": "...", "region": "ABD",
      "tags": ["2FA ...", "..."], "price": "1.60", "currency": "USD", "stock": 64,
      "delivery": "instant", "min_quantity": 1, "max_quantity": 5000
    }
  ],
  "meta": { "page": 1, "per_page": 50, "total": 223, "last_page": 5 }
}

delivery: instant = anında teslim · preorder = 0–3 saat içinde teslim (ön sipariş, destek saatlerinde) · notify = şu an satılamıyor. price birim fiyattır; 100 ve üzeri adette %5, 250 ve üzeri adette %10 indirim otomatik uygulanır. Stok ve fiyat canlıdır; kesin sonuç satın alma cevabıdır.

GET/api/v1/products/{id}

Tek ürün; alanlar listedekiyle aynı.

Satın alma

POST/api/v1/purchase

ALAN	AÇIKLAMA
`product_id`	Zorunlu. Ürün numarası.
`quantity`	Zorunlu. 1–5000.
`client_reference`	Önerilir. Sizin ürettiğiniz UUID. Aynı değerle tekrar gönderilen istek ikinci kez ücretlendirilmez; ilk sipariş `"replayed": true` ile döner.

curl -X POST https://projelikmail.com/api/v1/purchase \
  -H "X-API-Key: kom_..." -H "Content-Type: application/json" \
  -d '{"product_id": 421, "quantity": 2, "client_reference": "3f8a1c22-9e4b-4f2a-bd51-0c7e5a9d1234"}'

201
{
  "success": true,
  "data": {
    "order_id": 1052, "status": "completed", "product_id": 421, "product": "...", "quantity": 2,
    "unit_price": "1.60", "discount": "0.00", "total_price": "3.20", "currency": "USD",
    "accounts": ["[email protected]:password1", "[email protected]:password2"],
    "new_balance": "122.20"
  }
}

status: completed = hesaplar accounts içinde · processing = tedarikçiden alınıyor (genelde saniyeler) · waiting = ön sipariş (deadline_at'e kadar) · review = kontrol ediliyor · failed/refunded = tutar bakiyenize iade edildi.
completed değilse GET /api/v1/orders/{id} ile birkaç saniyede bir sorgulayın.
Hesap satırının biçimi ürüne göre değişir (çoğunlukla e-posta:şifre, bazılarında ek alanlar). Ürün açıklamasına bakın.
Kalan stok kuralı: bir üründen geriye 1–4 adet bırakılamaz; son 5 ve altı kaldıysa tamamı alınır.
Bağlantı koparsa ya da zaman aşımı olursa aynı client_reference ile güvenle tekrar gönderin. Hata cevaplarında (4xx/5xx) ücret alınmamıştır.

Siparişler

GET/api/v1/orders?page=1&per_page=20

Siparişleriniz, en yeniden eskiye (sitede verdikleriniz dahil; via: web ya da api). Hesaplar bu listede yoktur. per_page en fazla 100.

GET/api/v1/orders/{id}

Tek sipariş; teslim edildiyse accounts dolu gelir. Alanlar satın alma cevabıyla aynıdır.

Hatalar

HTTP	error_code	ANLAMI
401	`invalid_key`	Anahtar yok, geçersiz, iptal/süresi dolmuş ya da API erişimi kapalı
403	`wrong_site`	Hesap bu sitenin hesabı değil
422	`validation_failed`	Geçersiz alan (ürün, adet, client_reference)
404	`product_not_found`	Ürün yok ya da satışta değil
400	`insufficient_balance`	Bakiye yetersiz
400	`insufficient_stock`	Yeterli stok yok (mesajda mevcut adet yazar)
400	`order_rejected`	Diğer kural ihlalleri (kalan stok kuralı, en az adet vb.)
409	`price_changed`	Fiyat güncellendi; ürünü yeniden çekip tekrar deneyin
409	`request_in_progress`	Aynı client_reference ile bir istek hâlâ işleniyor
503	`temporarily_unavailable`	Ürün şu an temin edilemiyor ya da ön sipariş destek saatleri dışında
404	`order_not_found`	Sipariş yok ya da sizin değil
429	`rate_limit_exceeded`	İstek sınırı aşıldı; `Retry-After` kadar bekleyin

Sınırlar

Tüm istekler: dakikada 240 · Ürün listesi: dakikada 60 · Satın alma: dakikada 30 (hesap başına, tüm anahtarlar ortak).
Ürün listesini önbelleğe alın (birkaç dakikada bir yenilemek yeterli); kesin stok/fiyat kontrolü satın alma anında yapılır.

SMM paneli uyumlu uç nokta (v2)

SMM panelinize bizi "API sağlayıcı" olarak ekleyebilirsiniz. Adres: https://projelikmail.com/api/v2 · İstekler POST, form ya da JSON; anahtar key alanında.

action	PARAMETRELER	CEVAP
`balance`	—	`{"balance":"125.40","currency":"USD"}`
`services`	—	Ürün listesi: `service, name, category, rate, min, max`. `rate` 1000 adetlik fiyattır (SMM standardı).
`add`	`service, quantity` (`link` yok sayılır)	`{"order":1052}`
`status`	`order` ya da `orders`=1,2,3 (en fazla 100)	`{"charge":"3.20","start_count":"0","status":"Completed","remains":"0","currency":"USD"}`
`accounts`	`order`	Teslim edilen hesaplar: `{"status":"Completed","accounts":["..."]}`

Durumlar: Completed, In progress, Pending (ön sipariş), Canceled (iade edildi). Hatalar {"error":"..."} biçimindedir. v2'de tekrar güvenliği (client_reference) yoktur; bağlantı koparsa önce status ile kontrol edin.

curl -X POST https://projelikmail.com/api/v2 -d "key=kom_..." -d "action=add" -d "service=421" -d "quantity=10"

Destek

Entegrasyonla ilgili sorularınız için iletişim sayfasından bize ulaşın; sipariş numarasını (order_id) yazmayı unutmayın.