Introduction à l'API Diamy

L'API Diamy vous permet d'intégrer nos fonctionnalités de téléphonie dans vos applications et services.

Version actuelle

La version actuelle de l'API est v2.0. La v1.0 reste disponible mais sera dépréciée le 31 décembre 2023.

Premiers pas

Pour commencer à utiliser l'API Diamy, vous aurez besoin d'une clé API. Vous pouvez en obtenir une dans les paramètres de votre compte administrateur.

URL de base

Endpoint API

https://api.diamy.fr/v2

Exemple de requête

Voici un exemple simple de requête pour récupérer la liste de vos appels récents :

curl -X GET "https://api.diamy.fr/v2/calls/recent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Réponse

{
  "status": "success",
  "data": {
    "calls": [
      {
        "id": "call_123456",
        "direction": "inbound",
        "from": "+33123456789",
        "to": "+33987654321",
        "duration": 142,
        "status": "completed",
        "timestamp": "2023-06-15T14:32:21Z"
      },
      {
        "id": "call_123457",
        "direction": "outbound",
        "from": "+33987654321",
        "to": "+33123456789",
        "duration": 67,
        "status": "completed",
        "timestamp": "2023-06-15T15:10:05Z"
      }
    ],
    "pagination": {
      "total": 42,
      "page": 1,
      "per_page": 10,
      "pages": 5
    }
  }
}

Ressources disponibles

L'API Diamy vous donne accès aux ressources suivantes :

Appels

Gérez les appels entrants et sortants, consultez l'historique et les statistiques.

Contacts

Accédez et gérez votre annuaire de contacts et groupes.

Messagerie vocale

Gérez les messages vocaux, les annonces et les paramètres.

Utilisateurs

Gérez les utilisateurs, les permissions et les préférences.

Étapes suivantes

Maintenant que vous avez une vue d'ensemble de l'API Diamy, vous pouvez explorer les sections suivantes :

Documentation