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

Girilen uluslararası numaranın Telegram hesabıyla ilişkili olup olmadığını 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="tg"'

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ı:

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

İşleniyor durumu yanıtı:

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

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

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

Dosya yükleme istek URL’i

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

Dosya yükleme istek parametreleri

Parametre	Açıklama
file	file, Bir dosya yükleyin; her satır E.164 formatında bir numara içermelidir
task_type	string, Görev tipi, “tg” olarak ayarlayın

Görev durum sorgulama istek URL’i

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

Görev durum sorgulama 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 biçimindeki telefon numarası	+41798284651
telegram	Numaranın etkin bir Telegram hesabına sahip olup olmadığı	yes, no

Yanıt formatı

Alan	Açıklama
created_at	Görevin oluşturulduğu zaman damgası
updated_at	Son görev durumu güncellemesinin zaman damgası
task_id	Benzersiz görev tanımlayıcısı
user_id	ID of user
status	Görev durumu: pending: Sıraya alındı ve bekliyor processing: İşleniyor exported: Sonuçlar indirilmeye hazır
total	İşlenen toplam telefon numarası
success	Numbers successfully identified
failure	İşlenemeyen numaralar
result_url	(İsteğe bağlı) Durum exported olduğunda sonuçların indirme URL’si

Durum kodları

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