API
À quoi sert API
Cet onglet crée des clés API. Une clé permet à vos propres outils, scripts ou autres applications de lire les données de votre espace (contacts, produits, commandes, factures et réponses aux formulaires) via l'API Okinta, et de créer, modifier ou supprimer des contacts.
Pour connecter des services comme le Calendrier Apple ou Peppol, utilisez plutôt Connecteurs.
Qui peut créer des clés
Le propriétaire et les administrateurs peuvent toujours créer des clés et voient toutes les clés de l'espace. Les autres membres le peuvent une fois qu'on leur a donné accès à Paramètres → API dans Équipe → Accès aux applications ; ils ne voient que leurs propres clés.
Une clé ne peut atteindre que ce que son créateur peut ouvrir dans l'application. Si ses accès sont réduits ou s'il quitte l'espace, la clé perd ces droits immédiatement.
Créer et révoquer une clé
Cliquez sur Créer une clé, donnez-lui un nom, choisissez ce qu'elle peut lire, écrire ou supprimer et quand elle expire, puis copiez-la. Elle n'est affichée qu'une seule fois.
Choisissez le mode Test pour essayer une intégration sans risque : un propriétaire ou un administrateur crée d'abord le bac à sable (carte Mode test), une copie cachée de l'espace avec des données d'exemple. Les clés de test ne fonctionnent que là, et les e-mails qu'il enverrait s'affichent dans la carte. Le propriétaire et les administrateurs peuvent aussi ajouter des webhooks sous les clés, pour qu'Okinta appelle votre serveur à chaque changement.
Cliquez sur Révoquer pour désactiver une clé immédiatement. Vous recevez une notification chaque fois qu'une clé est créée sur votre compte.
L'API est incluse dans les offres payantes. Consultez la section API de la documentation pour des exemples.
Conseil
Ces actions s'ouvrent à l'intérieur de Okinta dans un nouvel onglet. Inscrivez-vous ou connectez-vous pour les utiliser.
