Dokümantasyon

COM API’yi en ince noktasına kadar kullanmak

Bu rehber üretim entegrasyonu içindir: kimlik doğrulama, kanal seçimi, tekil/çoklu gönderim, zamanlama, kredi ve hata yönetimi.

1. Temel adresler

• https://api.com.seed.tr — API kökü
• X-Api-Key: com_… — proje token’ı (dashboard → Projeler)
• İsteğe bağlı Idempotency-Key — aynı isteğin çift yazılmasını önler
• Yanıttaki X-Request-Id — destek / log korelasyonu

2. Kanallar

Sağlayıcı önceliği: workspace kendi kanal ayarı → yoksa platform taban entegrasyon. Fiyat buna göre taban veya tenant entegrasyon fiyatıdır.

3. Tek kanal gönderim

POST /v1/wapi/send
  Header: X-Api-Key: com_xxx
  Content-Type: application/json

  {"to":"905551112233","message":"Merhaba","clientReference":"order-42"}
  

E-posta için /v1/mapi/send + subject / html. SMS için /v1/sapi/send.

4. Çoklu alıcı / kanal — Dispatch

POST /v1/dispatch
  {"to":"905551112233,1203630XXXXXXXXXX","channels":"whatsapp","message":"Kampanya metni"}
  

to virgül / satır ile ayrılır. WhatsApp grubu için sayısal grup id veya …@g.us yazın; e-posta sanılmaz.

5. Zamanlanmış gönderim

POST /v1/scheduled
  {"channel":"wapi","to":"1203630XXXXXXXXXX","message":"Hatırlatma","sendAt":"2026-09-21T09:00:00+03:00"}
  

Dashboard → Zamanlanmış görevler ekranından da aynı alanlar doldurulur. Grup id kabul edilir.

6. Kendi cron job’unuzdan (OTP yerine)

Harici scheduler (Windows Task, Kubernetes CronJob, cPanel cron) ile periyodik grup mesajı:

curl -sS -X POST "https://api.com.seed.tr/v1/wapi/send" \
    -H "X-Api-Key: $COM_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"to":"1203630XXXXXXXXXX","message":"Günlük özet"}'
  

Kanal her zaman WhatsApp tipinde (wapi / whatsapp); hedef kişi yerine grup id yeterlidir. Detay: Grup mesajı rehberi.

7. Kredi

• Proje token bakiyesi gönderimde düşer
• Birim fiyat: taban entegrasyon veya tenant kendi entegrasyonu
• GET /v1/balance ile kalan bakiyeyi okuyun
• INSUFFICIENT_CREDIT → yükleme gerekir

8. Sık hata kodları

• UNAUTHORIZED — anahtar/oturum yok
• PROVIDER_UNAVAILABLE — kanal bağlı değil
• UNSUBSCRIBED — kişi tercihi kapalı (gruplar için uygulanmaz)
• WHATSAPP_QR_REQUIRED — QR oturumu yok

9. OpenAPI

İnteraktif deneme: /docs · şema: /openapi/v1.json · /swagger