Tiko — API Dokümantasyonu

Giriş

BASE URL · https://api.tiko.io/v1

Tiko API'si REST tabanlıdır; tahmin edilebilir kaynak odaklı URL'ler kullanır, JSON ile yanıt verir ve standart HTTP durum kodlarını döndürür. Tüm istekler HTTPS üzerinden yapılmalıdır.

GEThttps://api.tiko.io/v1/ping

Kimlik doğrulama

API anahtarınızı panodaki Ayarlar → API bölümünden alın. Her isteğe Authorization başlığı ile ekleyin. Anahtarınızı asla istemci tarafında paylaşmayın.

bashkopyala

curl https://api.tiko.io/v1/ping \
  -H "Authorization: Bearer sk_live_••••8f2a"

Hızlı başlangıç

Aşağıdaki istek, onaylı bir şablon kullanarak tek bir WhatsApp mesajı gönderir. Yanıt anında bir mesaj kimliği (id) döndürür.

Mesaj gönder

POST/v1/messages

Bir alıcıya metin veya şablon mesajı gönderir. Toplu gönderim için /v1/campaigns kullanın.

Parametre	Tip	Açıklama
`to`zorunlu	string	E.164 formatında alıcı numarası, örn. +90532•••84
`type`	string	`text` veya `template`. Varsayılan: text
`template`	string	Onaylı şablon adı, örn. siparis_onay
`variables`	object	Şablon değişkenleri anahtar-değer çiftleri

bash · istekkopyala

curl -X POST https://api.tiko.io/v1/messages \
  -H "Authorization: Bearer sk_live_••••8f2a" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+9053•••84",
    "type": "template",
    "template": "siparis_onay",
    "variables": { "ad": "Ayşe", "kod": "TK-4821" }
  }'

json · yanıt 201

{
  "id": "msg_8f2a91",
  "status": "queued",
  "to": "+9053•••84",
  "created": 1780143030
}

Durum sorgula

GET/v1/status/{id}

Bir mesajın güncel teslim durumunu döndürür: queued, sent, delivered, read veya failed.

Şablonlar

GET/v1/templates

Onaylı tüm mesaj şablonlarınızı listeler. Yeni şablonlar Meta onayından geçtikten sonra otomatik olarak burada görünür.

Kampanyalar

POST/v1/campaigns/send

Bir segmente toplu kampanya gönderir. Gönderim hız sınırlarını otomatik yönetir ve ilerlemeyi webhook ile bildirir.

Webhook'lar

Tiko, hesabınızda yapılandırdığınız URL'ye gerçek zamanlı olay bildirimleri gönderir. Her istek imzalıdır; X-Tiko-Signature başlığını doğrulayın.

Olay	Tetiklenme
`message.sent`	Mesaj WhatsApp'a iletildiğinde
`message.delivered`	Alıcıya teslim edildiğinde
`message.read`	Alıcı okuduğunda
`message.replied`	Alıcı yanıt verdiğinde

json · webhook gövdesi

{
  "event": "message.delivered",
  "id": "msg_8f2a91",
  "timestamp": 1780143114,
  "latency_ms": 84
}

Hata kodları

Kod	Anlam
`200 / 201`	Başarılı
`202`	Kabul edildi · işleniyor (örn. şablon onayı)
`401`	Geçersiz veya eksik API anahtarı
`422`	Geçersiz parametre · gövdeyi kontrol edin
`429`	Hız sınırı aşıldı · daha sonra tekrar deneyin

Yardıma mı ihtiyacınız var? Ekibimize yazın →