Récupérer les relevés d’appels du compte
Consultez les relevés d’appels entrants ou sortants de votre compte API. Ces relevés contiennent des informations privées sur les appels et la facturation. Réservez leur utilisation aux traitements autorisés côté serveur et évitez toute journalisation ou tout partage inutile.
Ce point de terminaison hérité utilise actuellement une période par défaut fixe et ne propose aucune pagination. Utilisez le parcours d’historique et d’exportation des appels du portail si vous avez besoin d’une autre période de rapport ou d’exports historiques volumineux ; les paramètres de dates personnalisées de ce point de terminaison ne sont pas fiables.
Requêtes
Authentifiez-vous via HTTPS avec votre compte API activé, depuis l’adresse IP source autorisée pour ce compte. L’exemple utilise des identifiants stockés dans des variables d’environnement. Aucun corps n’est nécessaire pour les requêtes prises en charge portant sur la période par défaut.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Chemin | Périmètre |
|---|---|
| /v3/cdrs | Relevés d’appels entrants du compte pour la période par défaut. |
| /v3/cdrs/{number} | Relevés d’appels entrants dont le numéro correspond exactement au numéro fourni. Privilégiez le numéro complet, avec tous les chiffres utilisés dans votre inventaire. |
| /v3/cdrs/all/outbound | Relevés d’appels sortants du compte pour la période par défaut. La branche de traitement des appels sortants ignore le premier argument du chemin ; all sert ici de valeur de remplacement et ne constitue pas un caractère générique pour les appels entrants. |
Utilisez exactement la valeur de direction inbound ou outbound indiquée ci-dessus. La branche de traitement des appels sortants ne met pas en œuvre de filtre par numéro. Ajouter un numéro à ce chemin ne restreint pas les résultats des appels sortants.
Période de rapport par défaut
La requête commence à minuit à la date du calendrier du serveur située 30 jours avant aujourd’hui et se termine à minuit au début de la journée d’aujourd’hui. Elle n’inclut donc pas le reste de la journée en cours. Il ne s’agit pas d’une période glissante de 720 heures se terminant à l’heure actuelle.
L’implémentation actuelle ne prend pas en charge de manière fiable les champs de formulaire date_from/date_to : lorsque des dates personnalisées sont fournies, les variables d’année de partition restent non définies. N’utilisez pas ces champs pour un rapport en production. Les dates dans la chaîne de requête et les paramètres de pagination ne sont pas implémentés comme solutions de remplacement.
Réponse
Seuls quelques champs des appels entrants sont présentés à titre d’illustration ; ces données sont fictives et ne constituent pas le relevé complet renvoyé.
{
"status": {
"code": "200",
"msg": "",
"results": 1
},
"response": [
{
"number": "12025550123",
"callerid": "12025550124",
"disposition": "ANSWERED",
"billseconds": "60",
"billcost": "0.0100",
"callsid": "11111111111111111111111111111111",
"date_created": "2026-10-01 12:00:00 UTC"
}
]
}response est une liste. L’enveloppe de réponse commune peut inclure status.results pour indiquer le nombre de lignes. Les codes de résultat peuvent être des chaînes de caractères. En l’absence de relevés, le résultat utilise le code API 404 avec le message No entries found, au lieu d’une liste vide accompagnée d’un statut de réussite.
Champs des relevés
| Champs | Signification |
|---|---|
| number, callerid | Numéro entrant et identifiant de l’appelant dans la projection des appels entrants. |
| calling, called, callerid | Identifiants de l’appelant et de l’appelé dans la projection des appels sortants. Ne déduisez pas de l’identifiant de l’appelant que l’identité de l’abonné est vérifiée. |
| disposition, billseconds, billcost | État final enregistré de l’appel, durée facturée et montant de facturation enregistré. Les valeurs peuvent utiliser d’anciens formats de chaînes de caractères de la base de données. |
| callsid | L’identifiant UUID enregistré de l’appel, utilisé pour établir des corrélations. |
| date_created | Une chaîne de date et d’heure avec le suffixe littéral UTC, sans garantie qu’il s’agisse d’un horodatage ISO8601. Analysez explicitement le format renvoyé. |
| Autres champs | Les relevés d’appels entrants comprennent également des diagnostics sur les échecs, les coûts, les canaux, la qualité et l’origine ; les relevés d’appels sortants comprennent des diagnostics sur la région de terminaison. La réponse complète peut contenir des informations sur l’infrastructure et doit être traitée comme privée. |
Le point de terminaison n’ajoute ni tri explicite ni pagination. Ne présumez pas que les résultats sont classés du plus récent au plus ancien, que l’ordre des lignes est stable ou qu’un curseur de synchronisation incrémentale est disponible. Les champs de facturation renvoyés correspondent à des relevés d’appels enregistrés et ne constituent pas un devis pour un appel futur.
Erreurs et limites des rapports
Consultez à la fois le statut HTTP et les champs status.code/status.msg du contenu JSON. L’absence d’entrées pour le compte et la période sélectionnés renvoie le code API 404. Les restrictions d’authentification et d’adresse IP source s’appliquent également. Un rapport volumineux sans pagination ou une requête utilisant des dates personnalisées non fiables peut échouer ; interroger à répétition la table entière ne constitue pas une stratégie d’exportation incrémentale.
Le gestionnaire examiné contient des requêtes de lecture et n’effectue aucun débit du compte ni aucun lancement d’appel. Un relevé renvoyé ne prouve pas qu’une personne a répondu ; interprétez l’état final et la durée enregistrés en fonction de vos besoins de rapport.