Sipariş verme

1. Denetleyici seçinCopy Anchor Link

GET /checkers, hesabınızın sipariş verebileceklerini sizin fiyatlarınızla listeler. Her birinin whatsapp_status_detection gibi bir id değeri vardır ve telefon, e-posta veya kullanıcı adı alır. Bkz. Denetleyiciler.

curl "https://api.talismanleads.io/v1/checkers" \
  -H "Authorization: Bearer tl_live_your_key_here"

2. Listenizi gönderinCopy Anchor Link

En fazla 100.000 kayıt ve 4 MB'ı isteğin içine entries olarak koyun. Daha büyük bir liste için POST /uploads üzerinden bir bağlantı isteyin, dosyayı PUT ile bu bağlantıya gönderin, ardından upload_id değerini kullanın. Bağlantı 2 saat geçerlidir. API anahtarınızı bu bağlantıya göndermeyin.

• Dosya, her satırda bir kayıt olan bir .txt dosyasıdır; en fazla 200 MB ve 10.000.000 kayıt.
• Telefon numaralarını ülke koduyla yazın, örneğin +14155550142.
• Bir dosyadaki telefon numaraları tek bir ülkeden olmalıdır: en az %90'ı. Karışık bir listeyi ülke başına bir dosyaya bölün.
• Geçerli olmayan tek bir satır tüm listenin reddedilmesine yol açar ve yanıt örnekler gösterir.
• Yüklenen bir dosya sipariş için 24 saat bekler, sonra kaldırılır.
• Kaç API anahtarı kullanırsanız kullanın, aynı anda 20 dosya veya 100 MB bekletebilir ve günde 500 yükleme yapabilirsiniz. Bu sınırların altındayken, izin verilen herhangi bir boyutta bir dosya bunların üzerine eklenebilir.

Bağlantı isteyin

curl -X POST "https://api.talismanleads.io/v1/uploads" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_name":"list.txt","size_bytes":1048576}'

Dosyayı bu bağlantıya gönderin

UPLOAD_URL="PASTE_upload_url_FROM_THE_ANSWER_ABOVE"
curl --upload-file list.txt "$UPLOAD_URL" \
  -H "Content-Type: text/plain" \
  -w "%{http_code}\n"

3. Fiyatı görünCopy Anchor Link

POST /estimates kayıtları sayar ve fiyatı hesaplar, hiçbir ücret almaz. Her dosya en az 2.000 olarak faturalandırıldığından billed_entries, entries değerinden büyük olabilir.

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"]}'

4. Siparişi verinCopy Anchor Link

POST /orders bakiyenizden ücret alır ve işi kuyruğa koyar. Yeniden denemede sizden iki kez ücret alınamaması için bir Idempotency-Key gönderin: bkz. Güvenli yeniden deneme. Fiyattan emin olmak için expected_charge gönderin; sipariş başka bir tutara mal oluyorsa price_changed ile reddedilir. Büyük bir listenin okunması zaman aldığından yanıt için 5 dakikaya kadar süre tanıyın.

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"]}'

5. Durumunu izleyinCopy Anchor Link

GET /orders/{id} adresini en az 30 saniye arayla sorgulayın. Büyük bir dosya arka planda parçalara bölünür, ancak bir siparişin tek bir durumu ve tek bir toplamı vardır.

queued

Başlamayı bekliyor.

processing

Çalışıyor.

completed

Bitti, tüm parçalar tamamlandı.

partially_completed

Bitti, bazı parçalar başarısız oldu. Bu parçaların ücreti iade edilir: `refunded` geri gelen tutarı gösterir.

failed

Hiçbir parça tamamlanamadı. Alınan ücret iade edilir: `refunded` geri gelen tutarı gösterir.

Başka durumlar eklenebilir, bu yüzden bilmediğiniz bir durumu hâlâ çalışıyor olarak değerlendirin.

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

6. Sonucu alınCopy Anchor Link

GET /orders/{id}/results her parça için 15 dakika geçerli bir indirme bağlantısı verir. İstediğiniz zaman yeni bir bağlantı isteyebilirsiniz: sonuçlar saklanır. Dosya genellikle all.csv, bir elektronik tablo ve metin listeleri içeren bir zip ya da tek bir CSV'dir. Sütunlar eklenebilir, bu yüzden bunları konuma göre değil ada göre okuyun. API anahtarınızı bu bağlantılara göndermeyin.

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

Ücretler ve iadelerCopy Anchor Link

charge siparişin verildiğinde tuttuğu ücret, refunded ise bunun ne kadarının geri geldiğidir. Başarısız olan bir parçanın ücreti tamamen iade edilir; sağlayıcının eksik saydığı bir parçada ise fark, parçanın faturalandırıldığı asgari tutara kadar iade edilir. İkisi de otomatik olarak gerçekleşir.

Aynı denetleyicide aynı liste, yaklaşık bir gün içinde yeni bir Idempotency-Key ile gönderilirse yeni sipariş olarak yeniden ücretlendirilir ve yeni bir kontrol yerine önceki sonucunuzu döndürebilir.

Başka yerlerden verilen siparişlerCopy Anchor Link

Web sitesinde verdiğiniz siparişler de listelenir. API siparişleri web sitesinde Görevlerim bölümünde API rozetiyle görünür ve siz orada istemedikçe Telegram'a hiçbir şey göndermez.