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
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.
Fiyatı öğrenin
Fiyatı ve listeyle ilgili olası sorunları görmek için listenizi
POST /estimatesadresine gönderin. Hiçbir ücret alınmaz.Siparişi verin
Aynı listeyi bir
Idempotency-KeyilePOST /ordersadresine gönderin. Kaç kez gönderirseniz gönderin sipariş için bir kez ücret alınır.Sonucu alın
Sipariş bitene kadar
GET /orders/{id}adresini kontrol edin, ardından dosyayıGET /orders/{id}/resultsadresinden 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 /estimatesvePOST /ordersyanı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.