Principaux endpoints

L'API est organisée par ressources, chacune avec ses propres endpoints. Voici une carte des principales zones.

Démarrage rapide

Trois extraits prêts à l’emploi pour appeler l’API externe. Remplacez `yr_live_xxx` par votre clé personnelle (voir la page « Clés API et authentification »).

curl -X GET "https://api.yourang.ai.io/external/v1/contacts?limit=20" \
  -H "Authorization: Bearer yr_live_xxx" \
  -H "Accept: application/json"

Zones de l'API

• Contacts. Lire, créer, mettre à jour des contacts du CRM. Synchronisations bidirectionnelles avec les systèmes de gestion, imports périodiques depuis des sources externes.
• Appels. Récupérer l'historique des appels avec métadonnées, transcriptions, résumés. Déclencher des appels sortants de manière programmatique.
• Réservations. Créer, lire, modifier des réservations. Synchroniser le calendrier yourang.ai avec le PMS ou le logiciel de gestion.
• Commandes. Pour le module Boutique : créer des commandes depuis des systèmes externes, lire l'état, recevoir des confirmations de paiement.
• Documents. Charger et gérer la base de connaissances via API. Utile pour ceux qui maintiennent le catalogue/tarif dans un système source et veulent le répliquer dans yourang.ai.
• Webhooks. Configurer les URL auxquelles yourang.ai notifie les événements (voir page dédiée).

Cas d'usage typiques

• Sync logiciel de gestion → yourang.ai. Chaque nuit, le PMS publie les nouveaux contacts et les réservations du jour vers yourang.ai. L'assistant vocal travaille avec des données toujours alignées.
• yourang.ai → logiciel de gestion. Lorsque l'assistant enregistre une nouvelle réservation, il la reporte au logiciel de gestion principal via l'API. L'assistant devient un canal d'entrée vers le système central.
• Dashboard sur mesure. Un outil BI ou une feuille Excel connectée à l'API affiche des données agrégées personnalisées, au-delà de celles du tableau de bord standard.
• Automatisations avec n8n / Make. Workflows no-code qui réagissent aux événements yourang.ai pour orchestrer des actions dans d'autres systèmes : Slack, Notion, Airtable.

Pagination et filtres

Tous les endpoints de liste prennent en charge la pagination (limit + offset) et les filtres sur les principaux champs. Pour les exports massifs, il convient de paginer avec des tailles raisonnables (50 à 100 par page) plutôt que de tout demander d'un coup : évite les timeouts et la charge sur les systèmes.