Bestätigen Sie, dass Mobilbestand aktiviert ist
Verwenden Sie diese Suche erst, nachdem Mobilnummer-Bestand für Ihr Kundenkonto aktiviert wurde. Beziehen Sie ein aktuelles einzelnes Mobilpräfix über den Discovery-Workflow des Kontos. Der unterstützte Pfad fordert Funkbestand für dieses Präfix an. Er hängt nicht von einem übereinstimmenden Festnetz-Routing-Metadatensatz ab. Wenden Sie sich an den Support, wenn Sie unsicher sind, ob Ihr Konto oder Präfix aktiviert ist.
Die aktuelle Legacy-Route lehnt nicht jede nicht berechtigte Anfrage zuverlässig ab. Ein Konto ohne aktivierten Mobilbestand kann normalen Bestand erhalten, während die Antwort weiterhin info.is_mobile: 1 anzeigt. Ein gebührenfreies Präfix kann ebenfalls mit dieser Bezeichnung den Bestandszweig für gebührenfreie Nummern erreichen. Verwenden Sie diese Bezeichnung nicht allein zur Identifizierung des Mobildienstes, und senden Sie keine normalen oder gebührenfreien Präfixe an diesen Endpunkt. Verwenden Sie den bestätigten Mobilkatalog und den aktivierten Workflow des Kontos.
Behalten Sie jede Nummer mit ihrer eigenen Preisauswahl zusammen
Für jeden Kandidaten behalten Sie number, info.uuid und die price-Liste desselben Eintrags zusammen. Die Antwort enthält außerdem Präfix-/Gebiets-/Länder-Metadaten, Vertragsbedingungen und Registrierungsbeschränkungen. Kandidaten sind aufsteigend nach dem Monatspreis ihrer ersten Preisoption sortiert; es gibt keine garantierte stabile Reihenfolge für gleiche Preise. Ersetzen Sie die zurückgegebene Nummern-ID nicht durch eine Gebiets- oder Präfix-ID und koppeln Sie sie nicht mit der Preis-ID eines anderen Kandidaten.
Die vollständige Antwort kann zusätzliche Metadaten- und Preisfelder enthalten. Zurückgegebene features, Kanalwerte und restrictions beschreiben den Kandidaten; sie sind keine Garantie, dass Anrufe, SMS, MMS oder Fax bereits nutzbar sind. Kontoberechtigungen, Registrierung und der gewählte Dienstplan gelten weiterhin. Behandeln Sie die Platzhalter des Beispiels nicht als gültige IDs oder Preise.
Verwenden Sie eine kleine positive Menge
Beginnen Sie mit einer Menge von 1. Die normale Anbieteranfrage normalisiert eine nichtpositive Menge zu 1 und begrenzt den Wert Richtung Anbieter auf 300, aber die spätere Ergebnisverarbeitung verwendet weiterhin die ursprüngliche Eingabe. Eine Menge von null kann daher Bestand beim Anbieter anfordern und keine Kandidaten zurückgeben. Andere Legacy-Zweige setzen die angeforderte Ergebnisanzahl nicht durchgängig durch. Verlassen Sie sich nicht auf ein einzelnes universelles Maximum und senden Sie keine negativen, gebrochenen oder nichtnumerischen Werte. Kein unterstützter öffentlicher Suchfilter und kein Preis-ID-Body-Parameter ist für diese Route dokumentiert.
Unterscheiden Sie fehlenden Bestand von Nachschlagefehlern
Eine 404-Antwort kann nicht verfügbaren Bestand, deaktivierten Dienst, fehlgeschlagene Anbieterabfrage oder ungültige Katalogeinträge bedeuten. Behandeln Sie eine Zeitüberschreitung oder einen Anbieterfehler als unbekannte Verfügbarkeit, nicht als bestätigten Nullbestand. Aktualisieren Sie die Auswahl und wiederholen Sie mit Backoff, wo angebracht. Vermeiden Sie es, jeden Vermittlungsknoten wiederholt abzufragen. Der separate Endpunkt für die Mobilbestandsanzahl ist ein Snapshot-Hinweis und muss nicht mit der Länge der Kandidatenliste dieses Kontos übereinstimmen.
Vor dem Kauf erneut prüfen
Die Suche reserviert keinen Bestand. Der geprüfte Zweig versucht, bereits gekaufte Nummern auszuschließen, aber eine fehlgeschlagene lokale Reservierungsabfrage kann einen solchen Kandidaten im Ergebnis belassen. Verfügbarkeit, Eigentum, genehmigte Preise und Registrierung müssen vom Kaufworkflow geprüft werden. Verwenden Sie eine frische Auswahl mit der abgesicherten Kaufanfrage und gleichen Sie den Kontobestand nach jedem ungewissen Kaufergebnis ab, bevor Sie es erneut versuchen. Kaufen Sie niemals nur, weil ein Kandidat zurückgegeben wurde.
Anfrage
Verwenden Sie ein aktiviertes API-Konto über HTTPS von einer erlaubten Quell-IP-Adresse. Mobilbestand muss zusätzlich für das Kundenkonto aktiviert sein; die API-Authentifizierung allein aktiviert ihn nicht.
GET mit dem aktuellen einzelnen Präfixbezeichner und einer positiven ganzzahligen Menge im URL-Pfad. Die Menge steht standardmäßig auf 1, wenn sie weggelassen wird. Verwenden Sie das Beispiel mit 1; diese Route validiert oder erzwingt nicht durchgängig ein universelles Ergebnislimit.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
prefix_id | string | Ja | Die opake sichtbare ID eines berechtigten einzelnen Mobilpräfixes aus der Discovery. Verwenden Sie ein von Ihrem Konto unterstütztes Mobil-NPA/NXX-Vermittlungspräfix; ersetzen Sie es nicht durch eine Gebiets-ID, eine gruppierte Anzeige-ID, ein wörtliches Wahlpräfix oder ein gebührenfreies Präfix. |
quantity | integer | Nein | Angeforderte Anzahl von Kandidaten. Standardwert ist 1. Geben Sie eine bescheidene positive ganze Zahl an. Die normale Anfrage Richtung Anbieter begrenzt ihre Menge bei 300, aber das ist keine universell validierte Eingabe oder Garantie der Antwortgröße. |
Antwort
Prüfen Sie status.code und status.msg im JSON-Body sowie den HTTP-Status. Bei Erfolg ist response eine Liste von Nummernkandidaten, status.msg ist Results: gefolgt von der zurückgegebenen Anzahl, und status.results ist die serialisierte Listenlänge. Kandidatenpreise sind kontospezifisch. Das veranschaulichende gekürzte Beispiel verwendet Platzhalter statt echtem Bestand oder einem Tarifangebot. Nummern enthalten die Landesvorwahl ohne Pluszeichen; Bezeichner sind opake Strings.
Veranschaulichende Antwortform; keine Live-Kontodaten und keine aktuelle Preisangabe.
{
"status": {
"code": 200,
"msg": "Results: 1",
"results": 1
},
"response": [
{
"number": "12025550123",
"info": {
"uuid": "NUMBER_ID",
"prefix_uuid": "PREFIX_ID",
"country_iso": "US",
"is_mobile": 1
},
"price": [
{
"uuid": "PRICE_ID",
"monthly_price": "ACCOUNT_MONTHLY_PRICE",
"setup_price": "ACCOUNT_SETUP_PRICE",
"per_minute": "ACCOUNT_INCOMING_RATE",
"channels": "PLAN_CHANNELS"
}
],
"features": [
"voice",
"sms",
"mms",
"t38"
]
}
]
}Fehler
- 404: Ungültige Präfix-ID, Land oder Gebiet: aktualisieren Sie die Auswahl des einzelnen Mobilpräfixes.
- 404: Keine Nummern gefunden: kann keinen nutzbaren Bestand, deaktivierten Dienst, fehlgeschlagene Anbieterabfrage, nicht unterstützte Auswahl oder Kontoeinschränkungen bedeuten. Es ist kein Nachweis eines verbindlichen Null-Bestandszählers.
Verfügbarkeit und Nebenwirkungen
- Die Suche mietet oder reserviert keine Nummer, und der geprüfte Pfad belastet keinen Kaufbetrag. Sie kontaktiert den Bestandsanbieter und kann Zeit benötigen.
- Erfolgreiche Suchen schreiben kontobezogene Nummern- und Preis-Cache-Einträge sowie Abfrageprotokolle. Eine wiederholte Suche ist keine Reservierung, keine Preisfixierung und kein Kauf.
- Die zurückgegebenen Preise, Bedingungen, Beschränkungen und Fähigkeiten müssen für das ausgewählte Konto und die Nummer geprüft werden. Eine Funktionsbezeichnung begründet keine Aktivierung, keine Nachrichtenfreigabe und keine getestete Dienstfunktionalität.