🚀 Documentation de l'API REST

📋 Introduction

Bienvenue dans la documentation de l'API REST Genii by Tolk.ai. Cette API fournit un ensemble complet de points de terminaison pour gérer les ressources de votre application. Notre API suit les principes REST et utilise des méthodes HTTP et des codes d'état standard.

💡 URL de base : https://genii-api.tolk.ai/v1

📄 Type de contenu : toutes les requêtes et réponses utilisent le format JSON : Content-Type: application/json

🔐 Authentification

🔑 Authentification par clé API

L'API utilise deux clés d'authentification API. Incluez votre clé secrète et votre clé API publique dans x-public-key et x-secret-key dans votre en-tête en utilisant le schéma suivant :

x-public-key: pk_...YOUR_PUBLIC_API_KEY
x-secret-key: sk_...YOUR_SECRET_API_KEY

📝 Obtenir votre clé API

1. Connectez-vous à genii à l'adresse https://genii.tolk.ai
2. Accédez à la section API dans vos paramètres : https://genii.tolk.ai/settings/api
3. Nommez et générez une nouvelle clé API
4. Copiez et conservez en lieu sûr vos clés API publique et secrète

💻 Exemple d'authentification

bash
curl -H "x-public-key: pk_...YOUR_PUBLIC_API_KEY" \\
     -H "x-secret-key: sk_...YOUR_SECRET_API_KEY" \\
     -H "Content-Type: application/json" \\
     <https://api.example.com/v1/users>

❌ Réponses d'erreur

Les erreurs d'authentification renvoient un statut 401 Non autorisé: