Apple Massenprüfer für Telefonnummern API: Schnelle Verifizierung

Prüfen Sie die Apple-Details der eingegebenen globalen Nummer, ob es sich um ein Apple-Konto handelt

Beispielcode zum Hochladen der Erkennungsdatei:

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

Beispielcode zur Prüfung des Aufgabenstatus:

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

Antwort bei erfolgreichem Hochladen der Erkennungsdatei

{
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 20000,
  "estimated_amount": {
    "amount": "2.000000",
    "currency": "USD"
  },
  "message": "Task created successfully. Numbers are being validated and processed in the background.",
  "created_at": "2024-10-19T18:24:56.450567423Z"
}

Antwort für den Verarbeitungsstatus

{
  "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
}

Antwort, die anzeigt, dass die Aufgabe abgeschlossen ist, einschließlich der Download-URL für die Ergebnisse.

{
  "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",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Anfrage-URL zum Hochladen der Datei

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

Anfrageparameter zum Hochladen der Datei

Parameter	Beschreibung
file	file, hochzuladende Datei, jede Zeile sollte eine Telefonnummer im E.164-Format enthalten
task_type	string, Aufgabentyp, auf “apple” setzen

Anfrage-URL zur Aufgabenstatusprüfung

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

Anfrageparameter zur Aufgabenstatusprüfung

Parameter	Beschreibung
task_id	string, bei der Aufgabenerstellung zurückgegebene Task-ID

Ergebnisfelder

Feld	Beschreibung	Beispiel
Number	Telefonnummer im E.164-Format	+41798284651
apple	Ob die Nummer ein aktives Apple-Konto besitzt	yes, no

Antwortformat

Feld	Beschreibung
created_at	Zeitstempel der Aufgabenerstellung
updated_at	Zeitstempel der letzten Statusaktualisierung
task_id	Eindeutige Task-Kennung
user_id	Benutzer-ID
status	Aufgabenstatus: pending: In Warteschlange processing: Wird gerade verarbeitet exported: Ergebnisse zum Download verfügbar failed: Aufgabe fehlgeschlagen, der abgebuchte Betrag wird automatisch erstattet
total	Gesamtzahl der verarbeiteten Telefonnummern
success	Erfolgreich erkannte Nummern
failure	Nummern, deren Verarbeitung fehlgeschlagen ist
result_url	(Optional) Download-URL für die Ergebnisse, wenn der Status exported ist
actual_amount	(Optional) Tatsächlich abgerechneter Betrag, verfügbar nach Abrechnung der Aufgabe
estimated_amount	(Antwort bei Aufgabenerstellung) Geschätzter Betrag; die endgültige Abrechnung erfolgt nach Abschluss der Aufgabe

Statuscodes

Status	Beschreibung
200	free, Anfrage erfolgreich (z. B. Statusabfrage)
202	charge, Aufgabe erfolgreich erstellt; der geschätzte Betrag wird abgebucht
400	free, Ungültige Anfrage: Parameter oder Dateiformat fehlerhaft, Aufgabentyp nicht unterstützt oder weniger gültige Einträge als die Mindestmenge
401	free, Fehlender oder ungültiger API-Schlüssel
402	free, Unzureichendes Guthaben
404	free, Aufgabe nicht gefunden
413	free, Hochgeladene Datei zu groß
500	free, Interner Serverfehler; bitte später erneut versuchen