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 à 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 / 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

Exemple dans un format csv :

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

Exemple dans un format json :

[{"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"}}]