Botim-Alter-und-Geschlecht-Prüfer-API

Prüfen Sie Botim-Registrierungen und ergänzen Sie registrierte Nummern um Geschlecht und Alter.

Produktparameter

Parameter	Wert
Aufgabentyp	botim_gender
Eingabetyp	Telefonnummer im E.164-Format
Mindestens gültige Einträge	500

estimated_amount wird anhand der Kontopreise berechnet und ist für die Aufgabe maßgeblich.

Eingabeformat

Laden Sie eine .txt- oder .csv-Datei mit einer Telefonnummer pro Zeile hoch. E.164 wird empfohlen.

+14155552671
+442071838750

Aufgabe erstellen

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"'

Die API gibt eine Aufgaben-ID zurück. Verwenden Sie sie für die Statusabfrage.

Upload-Antwort

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

Aufgabenstatus prüfen

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"'

Fragen Sie ab, bis status den Wert exported hat. pending und processing sind nicht abgeschlossen.

Antwort während der Verarbeitung

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

Exportierte Antwort

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

Ergebnisfelder

Feld	Beschreibung	Beispiel
number / Number	Eingegebene Telefonnummer. CSV nutzt number, XLSX nutzt Number.	+14155552671
activated	Ob für die Nummer ein Konto erkannt wurde.	yes / no
gender	Erkanntes Geschlecht eines registrierten Botim-Kontos.	Male / Female / Unknown
age	Erkanntes Alter oder Altersintervall eines registrierten Botim-Kontos.	25-34

Ohne erkanntes Konto wird activated=no ausgegeben; fehlende Profildaten bleiben leer.

Ergebnisdatei verarbeiten

Laden Sie das Paket erst nach dem Export über result_url herunter und behalten Sie die Spaltennamen bei.

Antwortfelder

Feld	Beschreibung
created_at	Zeitpunkt der Erstellung.
updated_at	Zeitpunkt der letzten Aktualisierung.
task_id	Eindeutige Aufgaben-ID.
status	pending, processing, exported oder failed.
total	Anzahl gültiger Eingaben.
success	Erfolgreich verarbeitete Werte.
failure	Fehlgeschlagene Werte.
result_url	Download-URL nach dem Export.
actual_amount	Endgültiger Betrag, falls verfügbar.
estimated_amount	Geschätzter Betrag bei Erstellung.

Statuscodes

Status	Beschreibung
200	Anfrage erfolgreich.
202	Aufgabe erstellt und geschätzter Betrag belastet.
400	Ungültige Datei, nicht unterstützter Typ oder zu wenige gültige Einträge.
401	API-Schlüssel fehlt oder ist ungültig.
402	Guthaben reicht nicht aus.
404	Aufgabe nicht gefunden.
413	Datei ist zu groß.
500	Interner Fehler; später erneut versuchen.

Betriebshinweise

• Die Aufgabe ist asynchron; fragen Sie mit der Aufgaben-ID ab.
• Nur gültige normalisierte Nummern zählen zur Mindestmenge.
• Fehlgeschlagene Aufgaben werden gemäß Abrechnungsablauf automatisch erstattet.