01
Premiers pas
Bienvenue sur l'API AiChat Pro. Ce guide vous aide à intégrer un agent chat dans n'importe quelle application en quelques minutes.
# Créer votre premier agent chat
curl
-X POST https://aichat.rolanddansou.online/api/agents \
-H "Authorization: Bearer VOTRE_CLÉ_API" \
-H "Content-Type: application/json" \
-d '
{
"name": "Mon premier agent",
"instructions": "Tu es un assistant serviable",
"provider": "openai",
"model": "gpt-4o"
}'
02
Authentification
Toutes les requêtes nécessitent un token Bearer dans l'en-tête Authorization. Générez votre clé depuis la page Clés API.
Authorization:
Bearer
acp_votre_clé_api_ici
Gardez vos clés API secrètes. Ne les exposez jamais dans du code côté client ou des dépôts publics.
03
Agents Chat
Les agents sont au cœur d'AiChat Pro. Chaque agent a sa propre personnalité, ses instructions, ses outils et sa mémoire.
POST
/api/agents
— Créer un nouvel agent
// Corps de la requête
{
"name": "Agent Support Client",
"instructions": "Tu es un assistant support...",
"provider": "openai", // openai | anthropic | google
"model": "gpt-4o",
"temperature": 0.7,
"max_tokens": 1000
}
GET
/api/agents
— Lister tous les agents (paginé)
04
Conversations
Envoyez des messages aux agents et conservez l'historique des échanges sur plusieurs tours.
POST
/api/conversations/send
{
"agent_id": "agent-uuid",
"message": "Bonjour, j'ai besoin d'aide avec ma commande",
"conversation_id": "uuid-optionnel" // omettre pour démarrer
}
200
Réponse
{
"conversation_id": "conv-uuid-123",
"message": "Bien sûr ! Quel est votre numéro de commande ?",
"role": "assistant"
}
05
Outils webhook
Étendez les capacités de votre agent avec des webhooks. L'agent appelle automatiquement votre endpoint lorsque nécessaire.
{
"name": "verifier_meteo",
"description": "Obtenir la météo pour un lieu donné",
"webhook_url": "https://votre-api.com/meteo",
"method": "POST",
"headers": {
"X-Api-Key": "votre-clé-secrète"
}
}
06
SDK JavaScript
Le SDK JavaScript officiel encapsule l'API REST pour une intégration frontend simplifiée.
Installation
npm install @aichat/sdk
Utilisation
import
{ AiChatClient }
from
'@aichat/sdk'
;
const
client =
new
AiChatClient(
'https://aichat.rolanddansou.online'
,
'VOTRE_CLÉ_API'
);
// Envoyer un message
const
response =
await
client
.conversations()
.sendMessage({
agentId: 'votre-agent-id',
message: 'Bonjour !'
});
Besoin d'aide ?
Consultez les exemples sur GitHub ou
commencez votre essai gratuit
pour accéder au tableau de bord et à la référence API complète.