Bayi API belgeleri

REST tarzı JSON API. Anahtarınızı Panel > API bölümünden oluşturun. Tüm tutarlar TRY ve iki ondalıklı metin olarak döner.

Kimlik doğrulama ve sınırlar

Authorization: Bearer sk_xxx başlığı (alternatif: X-Api-Key).
İstek sınırı: anahtar başına dakikada 60 istek. Yanıtlarda X-RateLimit-Limit, X-RateLimit-Remaining; aşımda 429 + Retry-After.
Sipariş oluştururken Idempotency-Key başlığı zorunludur. Aynı anahtar + aynı gövde ile tekrar gönderilen istek yeni sipariş açmaz, ilk siparişi 200 ve Idempotent-Replayed: true ile döndürür. Aynı anahtar farklı gövdeyle kullanılırsa 409 idempotency_conflict.
Siparişler bakiyeden ödenir; yetersiz bakiyede 402 insufficient_balance.

Uç noktalar

GET /api/v1/services

Satıştaki paketler.

curl -H "Authorization: Bearer sk_xxx" https://smm.tituweb.net/api/v1/services

{"data":[{"id":12,"name":"İstediğin Kadar Instagram Takipçi","platform":"Instagram","category":"Instagram Takipçi","type":"custom","quantity":null,"min":100,"max":50000,"step":1,"price":null,"rate_per_1000":"79.90","currency":"TRY","link_type":"instagram_profile","refill_days":30,"cancel":true,"start_time":"0-1 saat","delivery_time":"1-24 saat"}]}

GET /api/v1/balance

curl -H "Authorization: Bearer sk_xxx" https://smm.tituweb.net/api/v1/balance
{"balance":"250.00","currency":"TRY"}

POST /api/v1/orders

Gövde (JSON veya form): package_id, link, quantity (sabit pakette paket adedi), isteğe bağlı coupon, allow_duplicate (aynı hedefte aktif sipariş varken yine de oluştur).

curl -X POST https://smm.tituweb.net/api/v1/orders \
  -H "Authorization: Bearer sk_xxx" \
  -H "Idempotency-Key: 3f6c1e0a-siparis-1001" \
  -H "Content-Type: application/json" \
  -d '{"package_id":12,"link":"https://www.instagram.com/ornekhesap/","quantity":1000}'

201 Created
{"order":{"id":"S2611ABC234","package_id":12,"status":"pending","status_label":"Beklemede","payment_status":"paid","link":"https://www.instagram.com/ornekhesap/","quantity":1000,"charge":"79.90","refunded":"0.00","currency":"TRY","start_count":null,"remains":null,"created_at":"2026-11-10T12:00:00+03:00","completed_at":null},"idempotent_replay":false}

GET /api/v1/orders/{id}

curl -H "Authorization: Bearer sk_xxx" https://smm.tituweb.net/api/v1/orders/S2611ABC234

GET /api/v1/orders?ids=S1,S2

En fazla 100 sipariş; bulunamayanlar için order_not_found.

Durumlar

awaiting_payment, pending (sırada), processing, completed, partial (kalan tutar bakiyeye iade), canceled, refunded, review (inceleme), expired.

Hata kodları

HTTP	code	Açıklama
400	`idempotency_key_required`	Idempotency-Key başlığı eksik/geçersiz
401	`unauthorized`	Anahtar eksik veya hatalı
401	`key_revoked`	Anahtar iptal edilmiş
402	`insufficient_balance`	Bakiye yetersiz
403	`account_suspended`	Hesap askıda
404	`package_not_found / order_not_found`	Kayıt bulunamadı
409	`package_unavailable`	Paket satışta değil veya sağlayıcı yok
409	`duplicate_active_order`	Aynı hedef+hizmette aktif sipariş var (allow_duplicate=1 ile geçilebilir)
409	`idempotency_conflict`	İstek anahtarı farklı gövdeyle kullanılmış
422	`invalid_link / invalid_quantity / validation_error`	Girdi doğrulaması başarısız
429	`rate_limited`	İstek sınırı aşıldı
503	`maintenance`	Bakım çalışması

{"error":{"code":"insufficient_balance","message":"Bakiyeniz bu işlem için yeterli değil.","order_id":"S2611ABC234"}}

SMM panel v2 uyumluluğu

POST https://smm.tituweb.net/api/v2 — alanlar: key, action (services, add, status, balance). add: service (paket kimliği), link, quantity, isteğe bağlı request_id (tekrar gönderim koruması). status: order veya orders (virgülle).

curl -X POST https://smm.tituweb.net/api/v2 -d key=sk_xxx -d action=add -d service=12 -d link=https://www.instagram.com/ornek/ -d quantity=1000 -d request_id=bayi-1001
{"order":"S2611ABC234"}