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 portabilité, et non son identifiant numérique en base de données ni un numéro de téléphone. Appliquez l’encodage d’URL à l’identifiant du projet 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"Traitez cette réponse de manière confidentielle
La réponse complète comprend les informations de facturation de l’opérateur cédant, notamment la valeur enregistrée de billing_pin, le compte de facturation, le téléphone, l’adresse, l’entreprise et les coordonnées du contact habilité. L’API ne masque pas ces champs. Demandez uniquement le statut ou la liste des numéros lorsque cela suffit à votre processus. N’enregistrez pas la réponse détaillée complète dans le stockage du navigateur, les outils d’analyse, les journaux publics ou les captures d’écran destinées à l’assistance, et ne présentez que les champs nécessaires à un client autorisé.
Structure de la réponse
Exemple fictif limité à certains champs ; des champs supplémentaires peuvent être renvoyés.
{
"status": {
"code": 200,
"msg": "Project Detail"
},
"response": {
"project": {
"id": 11,
"uniqueid": "PROJECT_EXAMPLE",
"project_name": "Example transfer",
"location": "US",
"status": 0,
"status_str": "Pending"
},
"counts": {
"total": 0,
"pending": 0,
"in_progress": 0,
"completed": 0,
"rejected": 0
},
"numbers": [],
"events": [],
"uploads": []
}
}Cet exemple volontairement partiel omet tous les identifiants et secrets de facturation ainsi que les coordonnées personnelles. Leur absence dans l’exemple ne signifie pas que la réponse réelle les masque.
| Section | Contenu |
|---|---|
| project | Identifiant numérique de la ligne, identifiant unique du projet, nom du projet, localisation, données enregistrées de facturation, de contact et d’adresse, date et heure de création et statut calculé. L’ancien champ désignant l’opérateur cédant s’écrit loosing_carrier. |
| counts | Nombre total de lignes de numéros et compteurs Pending, In Progress, Completed et Rejected. |
| numbers | La même projection des données des numéros que celle du point de terminaison de liste des numéros du projet, comprenant les commentaires du client et les valeurs de planification enregistrées. |
| events | Lignes d’événements enregistrées et champs de charge utile bruts et analysés, soumis aux limites de visibilité et de format du point de terminaison des événements. |
| uploads | Métadonnées des documents : identifiant numérique, upload_type, file_name, file_extension, date_created et download_url sous forme d’URL relative. Cette URL nécessite toujours une authentification du compte. |
Interpréter le récapitulatif et les métadonnées
Le statut calculé donne la priorité à In Progress, puis à Pending, puis à Completed, puis à Rejected, avec Pending comme valeur de repli. Un récapitulatif Completed peut coexister avec des numéros rejetés. Examinez les compteurs et les statuts des numéros plutôt que de supposer que la portabilité de chaque numéro est terminée.
La réponse contient les métadonnées des documents, et non les octets des fichiers. Elle ne comporte ni pagination ni curseur incrémental. Les requêtes de détail et de liste sont des lectures distinctes, et non un instantané unique dont la cohérence transactionnelle serait garantie. Les dates restent telles qu’elles sont enregistrées, sans conversion de fuseau horaire documentée. Utilisez uniqueid pour les routes du projet ; l’identifiant numérique du projet ne peut pas s’y substituer.
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 terminé un transfert.
Effets et déroulement du processus
Il s’agit de la route de détail de référence utilisée par la vue des commandes de portabilité du portail actuel. Le portail établit les correspondances des champs pour son interface et applique sa propre projection des données destinées au client ; ne supposez pas que la réponse brute de l’API est identique au JSON ou à la présentation du portail. Le gestionnaire de détail examiné ne modifie pas le projet et ne déclenche directement ni demande auprès d’un opérateur ni facturation.