Accès au compte et au projet
Utilisez un compte API activé via HTTPS depuis une adresse IP autorisée. Le projet doit appartenir à ce compte et ne doit pas être supprimé. Utilisez l’identifiant unique du projet issu du processus de commande de portage, et non son identifiant numérique en base de données ni un numéro de téléphone. Encodez l’identifiant du projet pour l’URL lors de la construction d’une requête.
Requête
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Réponse
Exemple de réponse fictif.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response est une liste. Un projet existant sans numéros renvoie une liste vide avec le code API 200 et une valeur de status.results égale à 0. Les projets inexistants renvoient, eux, le code API 404.
Champs des numéros
| Champ | Signification |
|---|---|
| id, number, isocode | Identifiant numérique de la ligne, texte du numéro de téléphone enregistré et code du pays. L’identifiant de la ligne n’est pas celui du projet. |
| status, status_str | Statut numérique et libellé connu correspondant. |
| foc | Valeur de planification enregistrée pour l’engagement ferme de commande. Elle peut être vide ; le gestionnaire ne la convertit pas vers un fuseau horaire ou un format d’horodatage documenté. |
| updated, date_created, date_completed | Valeurs enregistrées de mise à jour, de création et d’achèvement. Traitez explicitement les valeurs vides ; ne présumez pas du format ISO8601 et ne déduisez pas de fuseau horaire à partir de l’exemple fictif. |
| comment | Commentaire enregistré destiné au client. Affichez-le comme du texte, et non comme du HTML exécutable. |
Cette représentation omet le champ internal_comment réservé au personnel. Cela ne signifie pas que la recherche historique distincte portant sur un seul numéro utilise la même représentation.
Ordre des résultats et suivi
La requête trie les résultats par date de création croissante. Aucun ordre supplémentaire n’est garanti pour les lignes ayant la même date de création. Il n’y a ni pagination, ni curseur incrémental, ni filtre de date. Lisez la liste complète pour rapprocher les données d’un projet et ne considérez pas son nombre actuel de lignes comme un catalogue permanent.
Interpréter le statut du portage
| Valeur | Libellé |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Conservez le statut numérique et prévoyez les valeurs inconnues. Pour les libellés inconnus, la valeur enregistrée est utilisée en repli, sans garantie d’un nouveau libellé. Un statut d’achèvement enregistré ou une date planifiée ne constitue pas, à lui seul, un test du routage entrant ni de tous les services du numéro.
Erreurs et limites
Vérifiez à la fois la réponse HTTP et status.code/status.msg. Un projet inexistant, supprimé ou n’appartenant pas au compte renvoie le code API 404 avec un message indiquant que le projet est introuvable. Les restrictions d’authentification et d’adresse IP source s’appliquent également. Les exemples n’effectuent aucune requête réelle, et une réponse réussie ne prouve pas qu’un opérateur a accepté ou achevé un transfert.
Effets
Le gestionnaire examiné ne fait que lire le projet et les lignes de numéros qui y sont enregistrées. La réponse est un instantané, et non une confirmation de l’opérateur ni un test réel du service. Elle ne lance pas de portage, ne modifie pas le routage et ne débite pas le compte.