Aller au contenu principal
Audact
Explorer un workflow

Docs

Documentation développeur

La documentation développeur d’Audact couvre la référence de l’API, des guides sur les appels, les numéros, la confidentialité des données et les webhooks, la documentation des SDK pour TypeScript, Python et Go, et le guide Model Context Protocol. Chaque opération REST passe par un seul hôte de base, https://api.audact.ai/v1, avec une clé d’API de tenant ; l’essentiel est résumé sous les sections.

Documentation

  • Référence de l’API

    Toutes les opérations publiques de l’API Audact, générées à partir de la spécification OpenAPI.

  • Guides

    Documentation pas à pas sur les appels, les numéros, la confidentialité des données, les webhooks et plus encore.

  • SDK

    Bibliothèques clientes pour la plateforme Audact : TypeScript sur npm ; Go et Python ne sont pas encore publiés.

  • Guide MCP

    Connecter un client MCP avec une clé d’API de tenant : outils, rôles, confirmation et limites.

L’essentiel

Ce que toute intégration doit savoir d’abord.

  • Sujet
    Hôte de base
    Ce qui s’applique
    Une URL de base publique, https://api.audact.ai/v1, routée par chemin vers les services qui se trouvent derrière. Le point d’accès MCP est https://api.audact.ai/mcp/.
    Documenté dans
    URL de base
  • Sujet
    Clés et rôles
    Ce qui s’applique
    Une clé d’API de tenant comme jeton Bearer (Authorization: Bearer aud_live_…). Viewer lit ; Developer lit et écrit, sans suppression ; Owner peut aussi supprimer et modifier les paramètres. Les points d’accès d’organisation utilisent à la place une session d’organisation.
    Documenté dans
    Référence de l’APIGuide MCP
  • Sujet
    Tenants
    Ce qui s’applique
    Les clés d’API et le secret de webhook sont propres à chaque tenant, et chaque requête est délimitée par le tenant de la clé authentifiée, jamais par un champ de la requête. Une organisation peut posséder des tenants et en mettre un en pause avec disable.
    Documenté dans
    Modèle de tenants
  • Sujet
    Renvoi d’appel
    Ce qui s’applique
    Un appel renvoyé atteint un numéro Audact comme un appel entrant ordinaire. Le numéro appelant qu’il porte est défini par l’opérateur de l’abonné, pas par Audact.
    Documenté dans
    Renvoi d’appel
  • Sujet
    Webhooks
    Ce qui s’applique
    X-Audact-Signature porte un HMAC-SHA256 calculé sur l’horodatage et le corps brut, avec le secret de webhook du tenant. Jusqu’à quatre tentatives, puis la livraison est mise en file d’échec pendant 90 jours, avec renvoi manuel. La livraison se fait au moins une fois : rendez donc vos gestionnaires idempotents.
    Documenté dans
    Livraison des webhooks
  • Sujet
    Erreurs
    Ce qui s’applique
    Une seule enveloppe d’erreur (code, message et, lorsqu’ils sont présents, hint, details, request_id) sur chaque service ; un 429 porte Retry-After. Le contrôle des réponses a un délai de 40 ms : en cas de dépassement, le résultat est ALLOW avec fail_open: true et un événement compliance.fail_open. Le contrôle de politique avant la numérotation est lui aussi fail-open : si le moteur de politique est injoignable, l’appel se poursuit.
    Documenté dans
    Enveloppe d’erreurGovernance GateOutbound Eligibility
  • Sujet
    Acceptation
    Ce qui s’applique
    Un résultat n’est compté comme confirmé que lorsque le système qui le détient l’indique : une livraison de webhook est un 2xx de votre point d’accès, une réservation est un identifiant de réservation du calendrier. D’ici là, l’état est demandé. Ce qui a été mesuré du côté d’Audact, et quand, figure dans le statut ci-dessous.
    Documenté dans
    Proof
  • Sujet
    Accès
    Ce qui s’applique
    L’accès en production s’inscrit dans un contrat payant applicable. Les points d’accès ne sont pas tarifés séparément. Il n’existe pas de clés de production anonymes. Le mode sandbox, qui synthétise la séquence de webhooks d’un appel sortant sans passer d’appel réel, est un indicateur géré par la plateforme sur un tenant ou une clé.
    Documenté dans
    APIs

Statut

Ce qui est mesuré, élément par élément.

  • API REST

    L’API REST publique sur api.audact.ai/v1.

    API REST: Est-ce construit
    Est-ce construitOpérationnel aujourd’hui
    API REST: Puis-je y accéder
    Puis-je y accéderEarly Customer Program
    Pourquoi cet état
    Affirmation
    Opérationnel aujourd’hui · Early Customer Program
    Périmètre
    L’API REST publique sur api.audact.ai/v1. Le serveur MCP a sa propre entrée de registre.
    Fondement
    Mesuré le 21 octobre 2026 : GET https://api.audact.ai/v1/health renvoie 200 ; les routes /v1 protégées renvoient 401 avec le corps d’erreur standard. La référence publique à /docs/api-reference liste chaque opération publique.
    Ce que cela n’établit pas
    Que chaque opération individuelle a été vérifiée de bout en bout en production.
    Ce que vous pouvez obtenir aujourd’hui
    L’accès en production s’inscrit dans un contrat payant applicable. Les points d’accès ne sont pas tarifés séparément.
    Dernière vérification
    21 octobre 2026
    Où le vérifier
    /apis

  • Serveur MCP

    Le point d’accès MCP sur l’hôte de l’API ; chaque outil est confirmé séparément.

    Serveur MCP: Est-ce construit
    Est-ce construitOpérationnel aujourd’hui
    Serveur MCP: Puis-je y accéder
    Puis-je y accéderEarly Customer Program
    Pourquoi cet état
    Affirmation
    Opérationnel aujourd’hui · Early Customer Program
    Périmètre
    Le point d’accès MCP /mcp/ sur l’hôte de l’API et les outils qu’il expose. Pas le connecteur Anthropic, qui est une intégration distincte.
    Fondement
    Mesuré le 21 octobre 2026 : POST https://api.audact.ai/mcp/ sans clé renvoie 401 avec WWW-Authenticate: Bearer realm="audact" (le défi propre au serveur MCP).
    Ce que cela n’établit pas
    Que chaque outil derrière ce point d’accès fonctionne aujourd’hui. Cela se confirme outil par outil, et la confirmation est encore en suspens.
    Ce que vous pouvez obtenir aujourd’hui
    L’accès passe par la mise en place au sein d’un contrat payant applicable ; le serveur MCP n’est pas tarifé séparément.
    Dernière vérification
    21 octobre 2026
    Où le vérifier
    /mcp-server

  • SDK TypeScript

    npm install @audactcore/sdk.

    SDK TypeScript: Est-ce construit
    Est-ce construitOpérationnel aujourd’hui
    SDK TypeScript: Puis-je y accéder
    Puis-je y accéderEarly Customer Program
    Pourquoi cet état
    Affirmation
    Opérationnel aujourd’hui · Early Customer Program
    Périmètre
    La bibliothèque cliente TypeScript documentée à /docs/sdks/typescript. Pas les SDK Python et Go, qui ont leur propre entrée.
    Fondement
    Le SDK TypeScript est publié sur npm sous le nom @audactcore/sdk 0.4.0 (mesuré le 22 octobre 2026) ; des tests de parité couvrent 209 des 211 opérations documentées.
    Ce que cela n’établit pas
    Que chaque opération documentée a été exécutée via le SDK en production.
    Ce que vous pouvez obtenir aujourd’hui
    Inclus dans un contrat payant.
    Dernière vérification
    21 octobre 2026
    Où le vérifier
    /docs/sdks/typescript

  • SDK Python et Go

    Documentés ; aucun paquet publié pour l’instant.

    SDK Python et Go: Est-ce construit
    Est-ce construitEn développement
    SDK Python et Go: Puis-je y accéder
    Puis-je y accéderNon disponible
    Pourquoi cet état
    Affirmation
    En développement · Non disponible
    Périmètre
    Les bibliothèques clientes Python et Go documentées à /docs/sdks/python et /docs/sdks/go. Pas le SDK TypeScript, qui a sa propre entrée.
    Fondement
    Mesuré le 22 octobre 2026 : les SDK Python (audact) et Go (github.com/audactai/audact-go-sdk) sont construits dans le dépôt du produit, mais aucun n’est publié : PyPI et le proxy de modules Go renvoient tous deux 404.
    Ce que cela n’établit pas
    La date de publication publique des paquets.
    Ce que vous pouvez obtenir aujourd’hui
    Rien à installer pour l’instant.
    Dernière vérification
    22 octobre 2026
    Où le vérifier
    /docs/sdks

  • Contrôle pour vos propres agents texte

    Un point d’accès compatible OpenAI qui contrôle les réponses de votre propre agent par rapport à vos règles.

    Contrôle pour vos propres agents texte: Est-ce construit
    Est-ce construitEn tests contrôlés
    Contrôle pour vos propres agents texte: Puis-je y accéder
    Puis-je y accéderSur demande
    Pourquoi cet état
    Affirmation
    En tests contrôlés · Sur demande
    Périmètre
    Un point d’accès compatible OpenAI qui vérifie les réponses de l’agent texte propre à un client au regard des règles du client avant leur renvoi, et enregistre chaque vérification. Il vérifie des réponses, pas des actions dans d’autres systèmes.
    Fondement
    A satisfait aux cinq conditions QA sur staging le 20 octobre 2026 : blocage, modification, vérification de chaque réponse dans l’exécution de test, et enregistrement de chaque vérification.
    Ce que cela n’établit pas
    Qu’il fonctionne en production, et comment il se comporte sous charge de production.
    Ce que vous pouvez obtenir aujourd’hui
    Accès développeur sur demande, au sein d’un contrat payant applicable ; sans tarif distinct.
    Dernière vérification
    24 octobre 2026
    Où le vérifier
    /docs

Voir aussi