RCS Denetçi API'si: Hızlı Telefon Numarası RCS Doğrulaması

Yüklenen bir dosya tabanında gelen global telefon numaralarının RCS mesajlaşmayı destekleyip desteklemediğini kontrol edin.

Dosya yükleme örneği:

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

Görev durumunu kontrol etme örneği:

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
}

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

Parametre	Açıklama
file	file, Dosya yükleyin, her satır E.164 formatında bir telefon numarası içermelidir
task_type	string, Görev tipi, “rcs” olarak ayarlayın

Görev durumunu kontrol etme istek URL’i

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

Görev durumunu kontrol etme istek parametreleri

Parametre	Açıklama
task_id	string, Görev oluşturma sırasında dönen görev kimliği

Sonuç alanları

Alan	Açıklama	Örnek
Number	E.164 formatında telefon numarası	+12025551234
rcs	Numaranın RCS etkinleştirilip etkinleştirilmediği	yes, no

Yanıt formatı

Alan	Açıklama
created_at	Görev oluşturulduğunda zaman damgası
updated_at	Son görev durumu güncellemesinin zaman damgası
task_id	Benzersiz görev tanımlayıcısı
user_id	Kullanıcı kimliği
status	Görev durumu: pending: Sırada bekleniyor processing: İşleniyor exported: Sonuçlar indirmeye hazır
total	İşlenen toplam telefon numarası sayısı
success	Başarıyla tanımlanan numaralar
failure	İşlenemez numaralar
result_url	(İsteğe bağlı) Status exported olduğunda sonuçlar için indirme URL’i

Durum kodları

Durum	Açıklama
200	charge, İstek başarılı, görev oluşturuldu veya durum alındı
400	free, Hatalı istek, geçersiz parametreler veya dosya formatı
500	free, İç sunucu hatası, daha sonra yeniden deneyiniz