Botim Yaş ve Cinsiyet Kontrol API'si

Telefon numarasına göre Botim kaydını kontrol eder ve gönderilen her numara için kayıt durumuyla birlikte yapay zekâ tahminli yaş ve cinsiyeti döndürür. Profil tabanlı gruplamayı kolaylaştırır. Görev, standart asenkron toplu iş akışını kullanır.

Ürün parametreleri

Parametre	Değer
Görev türü	botim_gender
Girdi türü	E.164 biçiminde telefon numarası
Minimum geçerli kayıt	500

estimated_amount hesap fiyatına göre hesaplanır ve görev için geçerli tahmini tutardır.

Girdi biçimi

Her satırda bir numara bulunan .txt veya .csv dosyası yükleyin. E.164 önerilir.

+14155552671
+442071838750

Görev oluştur

POST https://api.checknumber.ai/v1/tasks

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="botim_gender"'

API bir görev kimliği döndürür. Durum sorgusu için saklayın.

Yükleme yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 500,
  "estimated_amount": {
    "amount": "0.350000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Görev durumunu sorgula

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

status değeri exported olana kadar sorgulayın. pending ve processing tamamlanmış değildir.

İşleme yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 500,
  "success": 250,
  "failure": 0
}

Dışa aktarma yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 500,
  "success": 500,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "0.350000",
    "currency": "USD"
  }
}

Sonuç alanları

Alan	Açıklama	Örnek
number / Number	Girdi numarası. CSV number, XLSX Number kullanır.	+14155552671
activated	Numara için hesap algılanıp algılanmadığı.	yes / no
gender	Kayıtlı Botim hesabı için algılanan cinsiyet.	Male / Female / Unknown
age	Kayıtlı Botim hesabı için algılanan yaş veya yaş aralığı.	25-34

Hesap bulunmayan satırlar activated=no döndürür; profil verisi yoksa alanlar boştur.

Sonuç dosyasını işleme

Paketi yalnızca dışa aktarıldıktan sonra result_url üzerinden indirin ve sütun adlarını koruyun.

Yanıt alanları

Alan	Açıklama
created_at	Oluşturma zamanı.
updated_at	Son güncelleme zamanı.
task_id	Benzersiz görev kimliği.
status	pending, processing, exported veya failed.
total	Toplam geçerli girdi.
success	Başarıyla işlenen değerler.
failure	Başarısız değerler.
result_url	Dışa aktarma sonrası indirme URL’si.
actual_amount	Varsa nihai tutar.
estimated_amount	Oluşturmadaki tahmini tutar.

Durum kodları

Durum	Açıklama
200	İstek başarılı.
202	Görev oluşturuldu ve tahmini ücret uygulandı.
400	Geçersiz dosya, desteklenmeyen tür veya yetersiz kayıt.
401	API Key eksik veya geçersiz.
402	Yetersiz bakiye.
403	Ürün hesabınız için kullanılamıyor (kaldırıldı veya yalnızca beyaz listedeki müşterilere açık); destekle iletişime geçin.
404	Görev bulunamadı.
413	Dosya çok büyük.
500	İç hata; daha sonra tekrar deneyin.
503	Ürün geçici olarak kullanılamıyor (bakım için duraklatıldı); ücret alınmaz, daha sonra tekrar deneyin.

Operasyon notları

• Görev asenkrondur; dönen kimlikle sorgulayın.
• Yalnızca geçerli ve normalize edilmiş numaralar minimuma sayılır.
• Başarısız görevler faturalandırma akışına göre otomatik iade edilir.