ÇözümDevi WhatsApp API
Kendi sisteminizden WhatsApp üzerinden müşterilerinize bildirim gönderin (kargo/sipariş vb.).
Tasarım: Kaynak-yönelimli, düz JSON. Kimlikler opak prefixli dizgelerdir (msg_, ctc_, snd_, tpl_) — ham veritabanı kimliği yoktur. Başarı HTTP durum koduyla, hatalar tek tip { "error": { ... } } zarfıyla döner.
⚠️ Kimlikler CASE-SENSITIVE'dir: base62 kodlamadır (0-9A-Za-z), yani msg_FkR ≠ msg_Fkr. Depolama katmanınızda büyük/küçük harf duyarlı karşılaştırma kullanın (ör. SQL Server'da BIN2/_CS_AS collation) — aksi halde farklı id'ler çakışır (satır çakışması).
Kimlik doğrulama: OAuth2 client_credentials. Panelden bir uygulama oluşturup client_id + client_secret alın; POST /oauth/token ile kısa ömürlü access token üretip diğer çağrılarda Authorization: Bearer <access_token> kullanın.
Tek yönlü: Siz gönderirsiniz; müşteri cevap verirse cevap ÇözümDevi panelinizde görünür. Şablon-öncelikli: 24 saatlik pencere dışında yalnız onaylı WhatsApp şablonu gönderilebilir.
Hız limiti: Uygulama başına (token/anahtar başına), SABİT saniye-penceresi — okuma 5/sn, gönderim 3/sn, token ucu 2/sn (client_id/IP başına). Aşımda 429 rate_limit_error + Retry-After. Ayrıca kanal başına günlük gönderim kotası (quota_exceeded) geçerlidir. Her yanıtta hem RateLimit-Limit/Remaining/Reset (IETF; Reset=kalan saniye) hem X-RateLimit-Limit/Remaining/Reset (X-Reset=Unix epoch) döner → adapter akıllı backoff yapabilir.
Her yanıtta Request-Id header'ı bulunur; destek talebinde paylaşın.
Authentication
- OAuth 2.0: OAuth2
Panel → Uygulamalar → Uygulamalarım'dan bir uygulama oluşturup client_id + client_secret alın. Bu bilgilerle POST /oauth/token (client_credentials) çağırıp access token üretin; API çağrılarında Authorization: Bearer <access_token> kullanın.
Security Scheme Type: | oauth2 |
|---|---|
OAuth Flow (clientCredentials): | Scopes:
|