Ein Ablauf, im Dashboard und in der API

Probieren Sie Checks im Dashboard aus und binden Sie dann Ihren Server über die API an dieselben Einzel- und Massenchecks an.

Kostenlos registrieren und starten Dienste entdecken

Mit einem Einzelcheck beginnen

Senden Sie Requests an https://api.numdetect.com mit einem API-Schlüssel, der auf Ihrem Server liegt. Im Dashboard können Sie mehrere Schlüssel erstellen, einen pro System, und jeden davon löschen. Legen Sie keinen Schlüssel in Frontend-Code ab.

cURL

curl "https://api.numdetect.com/api/v1/checks" \
  -H "Authorization: Bearer $NUMDETECT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "phone": "+12025550147",
  "products": [
    "whatsapp"
  ]
}'

Veranschaulichender Request mit einer Beispielnummer. Ersetzen Sie $NUMDETECT_API_KEY durch Ihren Schlüssel; jeder Lauf ist ein echter, kostenpflichtiger Check.

Was ein Check zurückgibt

Jede Eingabe erhält einen Eintrag pro Produkt. Lesen Sie zuerst registered: true und false sind eindeutig, null ist unbekannt. Ein Einzelcheck berechnet nur true und false; eine Mengengruppe wird vollständig berechnet, sobald ihr Batch abgeschlossen ist.

200 OK

{
  "id": "10000000-0000-4000-8000-000000000001",
  "input_kind": "phone",
  "input": "+12025550147",
  "country": "US",
  "charged": 4000,
  "results": [
    {
      "product_id": "whatsapp",
      "status": "success",
      "result": true,
      "price": 4000,
      "charged": 4000
    }
  ]
}

status: success: eine eindeutige Antwort; unknown: keine eindeutige Antwort; failed: das Produkt war nicht erreichbar. Nur success wird berechnet.
result: true: ein Konto wurde gefunden; false: kein Konto; null, wenn status nicht success ist.
info: Zusätzliche Felder, die einige Produkte liefern, etwa das WhatsApp-Business-Signal.
price: Der Preis dieses Produkts für den Check, in USD micros (1.000.000 = $1).
charged: Was tatsächlich berechnet wurde: der Preis bei eindeutiger Antwort, sonst 0.

Im Dashboard erkunden

Führen Sie im Dashboard ein paar Einzelchecks aus, um Eingaben und Antworten zu sehen, bevor Sie Ihre Integration schreiben.

Aktuellen Katalog abrufen

Rufen Sie die Produktliste ab, um zu sehen, welche Produkte angeboten werden, mit Eingabetypen, Ländern und Preisen. Übernehmen Sie diese nicht fest aus der öffentlichen Website.

Auftrag erstellen und verfolgen

Senden Sie beim Erstellen eines Checks oder eines Massenauftrags einen Idempotency-Key. Geht eine Antwort verloren, wiederholen Sie den Request mit demselben Schlüssel statt mit einem neuen.

Ablauf für Telefon-Massenprüfungen

1
Laden Sie die CSV- oder Textdatei hoch, mit den Produkten, der Spalte mit den Nummern und dem Höchstbetrag, den Sie zu zahlen bereit sind.
2
Die Liste wird nach Land aufgeteilt; jedes Land wird von jedem gewählten Produkt geprüft.
3
Verfolgen Sie den Auftrag bis zum Abschluss oder erhalten Sie einen Webhook.
4
Laden Sie eine Ergebnisdatei herunter, mit jeder ursprünglichen Zeile und einer Antwortspalte pro Produkt.

Keys auf dem Server behalten

Bis zu 10 Bearer-API-Schlüssel pro Konto, jederzeit löschbar.
Bei Abschluss eines Massenauftrags wird ein signierter Webhook gesendet.
Ergebnisdateien werden über einen Link heruntergeladen, der 10 Minuten gültig ist.

Verwenden Sie Umgebungsvariablen für Zugangsdaten und löschen Sie einen Schlüssel im Dashboard, wenn er offengelegt wurde. Nennen Sie bei Supportanfragen Check- oder Auftrags-IDs; fügen Sie niemals API-Schlüssel in Screenshots oder öffentliche Beispiele ein.

Bereit, Ihre Nummern zu prüfen?

Starten Sie direkt nach der Registrierung, ohne Freigabe. Laden Sie Guthaben auf und prüfen Sie dann echte Nummern.

Kostenlos registrieren und starten ↗