Cette fonction permet aux revendeurs et aux utilisateurs de récupérer des CDRs pour un numéro de client donné. La fonction vérifie le nom d'utilisateur et le mot de passe du revendeur/de l'utilisateur et si le numéro de client est vraiment lié à ce compte de revendeur / d'utilisateur. En cas de succès, la fonction renvoie un tableau codé JSON.
URL
/cdrs/getcalls/$PROFILE_ID/$START_DATE[/$END_DATE][/$FORMAT]?username=$USERNAME&password=$PASSWORD
- PROFILE_ID : l'ID du profil du revendeur / du client (numéro de client)
- START_DATE : la date de début à partir de laquelle vous souhaitez consulter les données (doit être inférieure à END_DATE)
- END_DATE : la date jusqu'à laquelle vous souhaitez consulter les données (facultatif, si cette date n'est pas définie, la date du jour est sélectionnée)
- FORMAT : peut être défini sur CSV pour télécharger les résultats sous forme de fichier CSV et JSON.
- USERNAME : nom d'utilisateur du revendeur / de l'utilisateur
- PASSWORD : le mot de passe du revendeur / de l'utilisateur
Échec
La fonction échouera si l'un de ces contrôles est invalide :
- Le nom d'utilisateur et le mot de passe du revendeur et de l'utilisateur doivent correspondre
- L'utilisateur qui est défini par PROFILE_ID doit être lié au compte du revendeur / de l'utilisateur
- START_DATE doit être plus petit que END_DATE
- L'écart entre START_DATE et END_DATE ne doit pas dépasser 3 mois
Valeur retournée
Cette fonction renvoie un tableau multidimensionnel encodé JSON
array( [INDEX] => array( ['type'] => TYPE, ['data'] => DATA ) )
INDEX = indice numérique [0, 1, …]
TYPE = l'une des valeurs suivantes :
- CALLIN
- CALLOUT
- DEV
- FAX
- HARDWARE
- PAY
- SERVICE
- SETUP
- SMS
- TRAVEL
DATA = un tableau avec ces indices :
- source = qui a passé l'appel si type=CALL, sinon le nom d'utilisateur
- destination = quel numéro était composé si type=CALL, sinon le nom du produit
- destination_name = quel pays a été composé si type=CALL, sinon une description d'un produit
- call_start = début de l'appel si type=CALL, sinon la date de facturation
- call_end = fin de l'appel si type=CALL, sinon la date de facturation
- quantity = quantité calculée
- price = le prix en centimes d'euro par quantité
- invoice = numéro de facture / du rapport
Example in CSV format:
CALLOUT,+35220333320,35220333000,"Luxembourg","2021-06-29,08:30:15",61,'20,2,7.00,N/A
CALLIN,+35220333000,35220333320,"2021-06-29 10:40:00",0,,0,0.00,N/A
Example in JSON format:
[{"type":"CALLIN","data":{"source":"+35220333000","destination":"35220333320","destination_name":null,"call_start":"2021-06-29
08:13:50","duration":"0","pbxextension":"","quantity":0,"price":"0.00","invoice":"N\/A"}},{"type":"CALLOUT","data":{"source":"+35220333320","destination":"35220333000","destination_name":"Luxembourg","call_start":"2021-06-29
08:24:31","duration":"61","pbxextension":"20","quantity":2,"price":"7.00","invoice":"N\/A"}}]