Confirmez que l'inventaire mobile est activé
N'utilisez cette recherche qu'une fois l'inventaire de numéros mobiles activé pour votre compte client. Obtenez un préfixe mobile individuel actuel via le flux de découverte du compte. Le chemin pris en charge demande l'inventaire sans fil pour ce préfixe. Il ne dépend pas d'un enregistrement de métadonnées de routage filaire correspondant. Contactez l'assistance si vous n'êtes pas sûr que votre compte ou votre préfixe soit activé.
La route héritée actuelle ne rejette pas de manière fiable chaque demande non éligible. Un compte sans inventaire mobile activé peut recevoir de l'inventaire ordinaire alors que la réponse indique encore info.is_mobile: 1. Un préfixe gratuit peut également atteindre la branche d'inventaire gratuit avec cette étiquette. N'utilisez pas cette étiquette seule pour identifier un service mobile, et n'envoyez pas de préfixes ordinaires ou gratuits à ce point de terminaison. Utilisez le catalogue mobile confirmé du compte et le flux activé.
Gardez chaque numéro avec sa propre sélection de prix
Pour chaque candidat, conservez ensemble number, info.uuid et la liste price de cette même entrée. La réponse contient également des métadonnées de préfixe/région/pays, des conditions contractuelles et des restrictions d'enregistrement. Les candidats sont triés par le prix mensuel de leur première option de prix, par ordre croissant ; il n'existe pas d'ordre stable garanti pour les prix égaux. Ne remplacez pas l'identifiant du numéro renvoyé par un identifiant de région ou de préfixe, et ne l'associez pas à l'identifiant de prix d'un autre candidat.
La réponse complète peut inclure des métadonnées et des champs de prix supplémentaires. Les features renvoyés, les valeurs de canaux et les restrictions décrivent le candidat ; ils ne garantissent pas que les appels, les SMS, les MMS ou le fax sont déjà utilisables. Les autorisations du compte, l'enregistrement et le forfait de service sélectionné s'appliquent toujours. Ne considérez pas les espaces réservés de l'exemple comme des identifiants ou des prix valides.
Utilisez une petite quantité positive
Commencez avec une quantité de 1. La demande normale au fournisseur normalise une quantité non positive à 1 et plafonne la valeur en amont à 300, mais le traitement ultérieur des résultats utilise encore l'entrée d'origine. Une quantité nulle peut donc demander de l'inventaire en amont et ne renvoyer aucun candidat. D'autres branches héritées n'appliquent pas de manière cohérente le nombre de résultats demandé. Ne vous fiez pas à un maximum universel unique et n'envoyez pas de valeurs négatives, fractionnaires ou non numériques. Aucun filtre de recherche public pris en charge ni paramètre de corps d'identifiant de prix n'est documenté pour cette route.
Distinguez l'absence de stock d'un échec de recherche
Une réponse 404 peut représenter un inventaire indisponible, un service désactivé, un échec de recherche auprès du fournisseur ou des enregistrements de catalogue invalides. Traitez un délai d'attente ou une défaillance du fournisseur comme une disponibilité inconnue plutôt qu'un stock nul confirmé. Actualisez la sélection et réessayez avec temporisation quand c'est approprié. Évitez d'interroger chaque central de manière répétée. Le point de terminaison distinct de comptage de l'inventaire mobile est un indice instantané et n'a pas besoin de correspondre à la longueur de la liste de candidats de ce compte.
Vérifiez à nouveau avant d'acheter
La recherche ne réserve pas de stock. La branche examinée tente d'exclure les numéros déjà achetés, mais un échec de recherche de réservation locale peut laisser un tel candidat dans le résultat. La disponibilité, la propriété, les tarifs approuvés et l'enregistrement doivent être vérifiés par le flux d'achat. Utilisez une sélection fraîche avec la demande d'achat protégée, et rapprochez l'inventaire du compte après tout résultat d'achat incertain avant de réessayer. N'achetez jamais uniquement parce qu'un candidat a été renvoyé.
Requête
Utilisez un compte API activé via HTTPS depuis une adresse IP source autorisée. L'inventaire mobile doit également être activé pour le compte client ; l'authentification API seule ne l'active pas.
GET avec l'identifiant de préfixe individuel actuel et une quantité entière positive dans le chemin d'URL. La quantité est 1 par défaut si elle est omise. Utilisez l'exemple avec 1 ; cette route ne valide ni n'applique de manière cohérente une limite de résultats universelle.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"| Nom | Type | Requis | Description |
|---|---|---|---|
prefix_id | string | Oui | L'identifiant visible opaque d'un préfixe mobile individuel éligible issu de la découverte. Utilisez un préfixe de central mobile NPA/NXX pris en charge par votre compte ; ne le remplacez pas par un identifiant de région, un identifiant d'affichage groupé, un préfixe de numérotation littéral ou un préfixe gratuit. |
quantity | integer | Non | Nombre de candidats demandé. 1 par défaut. Fournissez un nombre entier positif modeste. La demande normale en amont plafonne sa quantité à 300, mais ce n'est pas une entrée universellement validée ni une garantie de taille de réponse. |
Réponse
Examinez status.code et status.msg dans le corps JSON ainsi que le statut HTTP. En cas de succès, response est une liste de numéros candidats, status.msg est Results: suivi du nombre renvoyé, et status.results est la longueur de liste sérialisée. Les prix des candidats sont propres au compte. L'exemple abrégé illustratif utilise des espaces réservés au lieu d'un inventaire réel ou d'un devis tarifaire. Les numéros contiennent l'indicatif du pays sans signe plus ; les identifiants sont des chaînes opaques.
Forme de réponse illustrative ; il ne s'agit ni de données de compte réelles ni d'un devis actuel.
{
"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"
]
}
]
}Erreurs
- 404 : identifiant de préfixe, pays ou région invalide : actualisez la sélection du préfixe mobile individuel.
- 404 : aucun numéro trouvé : peut signifier l'absence de stock utilisable, un service désactivé, un échec de recherche auprès du fournisseur, une sélection non prise en charge ou des limitations du compte. Ce n'est pas la preuve d'un comptage d'inventaire nul faisant autorité.
Disponibilité et effets secondaires
- La recherche ne loue ni ne réserve un numéro et le chemin examiné ne débite pas de montant d'achat. Elle contacte le fournisseur d'inventaire et peut prendre du temps.
- Les recherches réussies écrivent des entrées de cache de numéros et de prix liées au compte ainsi que des journaux de requêtes. Répéter une recherche n'est ni une réservation, ni un verrouillage de prix, ni un achat.
- Les prix, conditions, restrictions et capacités renvoyés doivent être examinés pour le compte et le numéro sélectionnés. Une étiquette de fonctionnalité n'établit ni l'activation, ni l'approbation de la messagerie, ni une fonctionnalité de service testée.