İçeriğe geç

Amazon Toplu Numara Doğrulama API: Hızlı doğrulama

Girilen global numaranın Amazon hesabı olup olmadığını kontrol edin

Dosya yükleme örneği:

Terminal window
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./number.txt"' \
--form 'task_type="amazon"'

Görev durumunu kontrol etme örneği:

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

Dosya yükleme başarılı yanıtı:

{
"task_id": "d4g8o46p2jvh04o9uolg",
"status": "pending",
"total": 2049,
"message": "Task created successfully",
"created_at": "2025-11-21T15:58:08.916446594Z"
}

İşleniyor durumu yanıtı:

{
"created_at": "2025-11-21T08:27:09.933Z",
"updated_at": "2025-11-21T08:27:10.241Z",
"task_id": "d4g24nep2jvh04o9uoh0",
"user_id": "wfi7wGPS4B4PdtTMox5Y",
"status": "processing",
"total": 2049,
"success": 1024,
"failure": 0
}

Görev tamamlandı yanıtı (indirme URL’i dahil):

{
"created_at": "2025-11-21T08:27:09.933Z",
"updated_at": "2025-11-21T08:27:10.241Z",
"task_id": "d4g24nep2jvh04o9uoh0",
"user_id": "wfi7wGPS4B4PdtTMox5Y",
"status": "exported",
"total": 2049,
"success": 2049,
"failure": 0,
"result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

Dosya yükleme istek URL’i

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

Dosya yükleme istek parametreleri

ParametreAçıklama
filefile, Bir dosya yükleyin; her satır E.164 formatında bir numara içermelidir
task_typestring, Görev tipi, “amazon” olarak ayarlayın

Görev durum sorgulama istek URL’i

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

Görev durum sorgulama istek parametreleri

ParametreAçıklama
task_idstring, Görev oluşturma sırasında dönen görev kimliği

Sonuç alanları

AlanAçıklamaÖrnek
NumberE.164 biçimindeki telefon numarası+41798284651
amazonNumaranın etkin bir Amazon hesabına sahip olup olmadığıyes, no

Yanıt formatı

AlanAçıklama
created_atGörevin oluşturulduğu zaman damgası
updated_atSon görev durumu güncellemesinin zaman damgası
task_idBenzersiz görev tanımlayıcısı
user_idID of user
statusGörev durumu:
pending: Sıraya alındı ve bekliyor
processing: İşleniyor
exported: Sonuçlar indirilmeye hazır
totalİşlenen toplam telefon numarası
successNumbers successfully identified
failureİşlenemeyen numaralar
result_url(İsteğe bağlı) Durum exported olduğunda sonuçların indirme URL’si

Durum kodları

DurumAçıklama
200charge, istek başarılı; görev oluşturuldu veya durum alındı
400free, hatalı istek; geçersiz parametreler veya dosya biçimi
500free, Internal server error, retry later