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 avoir été supprimé. Utilisez l’identifiant unique du projet issu du processus de commande de portage, et non son identifiant numérique dans la base de données ni un numéro de téléphone. Appliquez l’encodage 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/events"Réponse
Exemple de réponse fictive.
{
"status": {
"code": 200,
"msg": "Project Events",
"results": 1
},
"response": [
{
"id": 31,
"subject": "Example project update",
"event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
"type": "comment",
"value": "Example update",
"source": "Example source",
"date_created": "2026-10-23 12:00:00"
}
]
}Un projet existant sans événement renvoie le code API 200, une liste vide et status.results égal à 0. Les résultats sont demandés par date de création décroissante, sans ordre supplémentaire en cas d’égalité, sans pagination, sans curseur et sans filtre de date.
Lisez attentivement les données de l’événement
id est l’identifiant numérique de la ligne de l’événement, subject est son objet enregistré et date_created est sa valeur de date et d’heure enregistrée. Le point de terminaison conserve la chaîne brute event et tente également d’en décoder les propriétés type, value et source. Si les données ne constituent pas un objet JSON ou si une propriété est absente, le champ correspondant issu de l’analyse est une chaîne vide.
Les données ne correspondent ni à une énumération fixe ni à un schéma garanti en texte brut. Ne considérez pas le texte de la source comme une identité vérifiée et n’affichez pas le contenu des événements en HTML. Réservez les événements bruts aux processus autorisés côté serveur et n’affichez aux utilisateurs autorisés que le texte approprié. Ce point de terminaison ne propose ni filtre distinct de visibilité des événements pour le personnel et les clients, ni masquage du contenu.
L’historique ne garantit pas la livraison
Il s’agit de l’historique enregistré du projet, et non d’un flux de notifications webhook, d’un curseur de synchronisation immuable ou d’un relevé complet de chaque modification de la base de données. Par exemple, l’ajout de numéros par le gestionnaire d’ajout de numéros examiné ne crée pas à lui seul d’événement. En plus de consulter les événements, effectuez un rapprochement de la liste des numéros et des décomptes par statut.
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. L’authentification et les restrictions sur l’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 portage.
Effets
Le gestionnaire examiné lit les événements enregistrés sans modifier le projet, lancer de portage ni débiter le compte. La visibilité des composants qui écrivent les événements et les tests avec un compte authentifié restent à examiner dans le cadre de la revue en attente du contrat de l’API.