Wählen Sie ein unterstütztes Präfix
Verwenden Sie ein aktuelles einzelnes Mobilfunk-Präfix aus der Discovery. Dieser Endpunkt ist für NANPA-Vermittlungsstellen gedacht: Ein NPA bezeichnet die Vorwahl, und ein NXX bezeichnet die Vermittlungsstelle. Ein Präfix nur mit Vorwahl ist zu breit. Senden Sie keine gruppierten Anzeige-IDs und leiten Sie nicht ab, dass ein anderes Land unterstützt wird, weil dessen Präfix genug Ziffern enthält.
Verwenden Sie die Zählung als Hinweis
Lesen Sie response.count, mit response.npa und response.nxx, das die Vermittlungsstelle identifiziert. Dies ist eine Momentaufnahme des Coverage-Dienstes, kein für Ihr Konto gehaltener Bestand. Bestätigen Sie tatsächliche Nummern, einschlägige Angebote und etwaige Registrierungsanforderungen, bevor Sie bestellen. Eine erfolgreiche Zählung autorisiert niemals einen Kauf.
Unterscheiden Sie Nullbestand von einer fehlgeschlagenen Suche
Eine erfolgreiche Zählung von Null unterscheidet sich von einem API-Fehler. Prüfen Sie status.code und status.msg sowie den HTTP-Status. Behandeln Sie eine Zeitüberschreitung oder fehlgeschlagene Suche als unbekannte Verfügbarkeit und versuchen Sie es später mit Backoff erneut.
Anfrage
Verwenden Sie die Anmeldedaten Ihres aktivierten API-Kontos über HTTPS. Basic-Authentifizierung und Bearer-Tokens aktivierter API-Konten werden unterstützt; Kontoeinschränkungen gelten.
GET mit der Präfix-Kennung im URL-Pfad. Es gibt keine dokumentierten Query- oder Body-Parameter.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
prefix_id | string | Ja | Kopieren Sie die einzelne Präfix-ID aus der Discovery-Antwort. Verwenden Sie ein unterstütztes NANPA-Mobilfunk-Präfix mit einer Vorwahl (NPA) und einer Vermittlungsstelle (NXX), nicht eine reine Vorwahl-Kennung oder eine gruppierte Zusammenfassungs-ID. Behandeln Sie die Kennung als opak. |
Antwort
Prüfen Sie status.code im JSON-Body sowie den HTTP-Status. Eine erfolgreiche response hat status.code 200 und status.msg Results. response ist ein Objekt, keine Liste: count ist eine ganzzahlige Bestandsmomentaufnahme; npa und nxx sind Zeichenketten aus drei Zeichen. status.results ist für dieses assoziative Objekt nicht vorhanden. Eine Zählung von 0 bedeutet, dass die Coverage-Suche keine passende Vermittlungsstelle fand oder Null Bestand zurückgab; sie beweist nicht, dass alle Anbieter oder anderen Discovery-Wege keine Nummern haben.
Veranschaulichende Antwortform; keine echten Kontodaten und kein aktuelles Angebot.
{
"status": {
"code": 200,
"msg": "Results"
},
"response": {
"count": 42,
"npa": "212",
"nxx": "555"
}
}Fehler
- 404: Anbieter deaktiviert: Mobile Bestandsabdeckung ist auf dem Dienst nicht verfügbar.
- 404: Ungültige Präfix-ID: Holen Sie eine aktuelle einzelne Präfix-ID aus der Discovery.
- 404: Ungültiges Präfix: Das gespeicherte Präfix enthält nicht genug Ziffern für eine NPA/NXX-Suche.
- 500: Bestandsabdeckung fehlgeschlagen: Die vorgelagerte Suche lieferte kein erfolgreiches Coverage-Ergebnis. Versuchen Sie es später mit Backoff erneut; ein Fehlschlag ist keine Bestandszählung von Null.
Verfügbarkeit und Nebenwirkungen
- Der Vorgang prüft den Bestand und erteilt keinen Auftrag, reserviert keine Nummern und belastet keinen Kaufbetrag.
- Der Bestand kann sich sofort ändern. Die Coverage-Zählung wird nicht angepasst, um kontospezifische Kaufbarkeit oder dieselbe Länge wie die nächste Nummernsuche-Antwort zuzusichern.
- Eine Suche kontaktiert den Coverage-Dienst und kann Zeit brauchen. Fragen Sie nicht wiederholt jedes Präfix ab und behandeln Sie eine Zeitüberschreitung oder einen Fehler nicht als erfolgreichen Nullbestand.