İçeriğe geç

Geliştiriciler

Her denetleyiciyi kendi sunucunuzdan çalıştırın

TalismanLeads API'si web sitesinin yaptığını yapar: bir liste gönderir, fiyatı görür, siparişi verir ve sonucu alırsınız. Aynı bakiyeden, aynı fiyatlarla ödersiniz.

Nasıl çalışır

  1. API anahtarı oluşturun

    Hesabınızda bir API anahtarı oluşturun. Yalnızca bir kez gösterilir, bu yüzden güvenli bir yerde saklayın.

  2. Fiyatı öğrenin

    Fiyatı ve listeyle ilgili olası sorunları görmek için listenizi POST /estimates adresine gönderin. Hiçbir ücret alınmaz.

  3. Siparişi verin

    Aynı listeyi bir Idempotency-Key ile POST /orders adresine gönderin. Kaç kez gönderirseniz gönderin sipariş için bir kez ücret alınır.

  4. Sonucu alın

    Sipariş bitene kadar GET /orders/{id} adresini kontrol edin, ardından dosyayı GET /orders/{id}/results adresinden alın.

Hızlı başlangıç

API anahtarını kendi anahtarınızla değiştirin. Temel adres https://api.talismanleads.io/v1 olup istekler ve yanıtlar JSON biçimindedir.

1. Ne kadar tutacağını görün

curl -X POST "https://api.talismanleads.io/v1/estimates" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

2. Siparişi verin

curl -X POST "https://api.talismanleads.io/v1/orders" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Idempotency-Key: crm-export-2026-11-05" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

3. Durumunu kontrol edin

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer tl_live_your_key_here"

4. Sonucu alın

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
  -H "Authorization: Bearer tl_live_your_key_here"

Bilmeniz gerekenler

  • Para tutarları her zaman ABD doları cinsinden bir dizedir, örneğin "18.00".
  • Her dosya, web sitesinde olduğu gibi API'de de en az 2.000 kayıt olarak faturalandırılır.
  • En fazla 100.000 kayıt ve 4 MB olan bir liste isteğin içinde gönderilebilir. En fazla 10.000.000 kayıt veya 200 MB olan daha büyük bir liste POST /uploads üzerinden gönderilir.
  • Bir siparişin durumunu en az 30 saniye arayla kontrol edin. Bir siparişin ne kadar süreceği boyutuna ve denetleyiciye bağlıdır.
  • POST /estimates ve POST /orders yanıtı için 5 dakikaya kadar süre tanıyın: büyük bir listenin okunması zaman alır. Daha kısa bir zaman aşımı, isteği boşuna yeniden göndermenize yol açar.

Bu sayfada