Akorbit API

Des APIs production-ready
pour votre IA souveraine.

Intégrez RAG, Text-to-SQL et agents IA dans vos applications en quelques lignes de code. APIs REST sécurisées, webhooks, SDKs officiels.

Auth Bearer REST / JSON HTTPS/TLS Webhooks
Voir la documentation Obtenir une clé API
POST /api/v1/agents/{id}/query
# Interroger un agent IA sur vos données RH

curl -X POST \
  "https://platform.akorbit.com/api/v1/agents/ag_rh_001/query" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Quelle est la politique de télétravail ?",
    "user_id": "user_482",
    "stream": false
  }'

# Réponse de l'API
{
  "answer": "La politique de télétravail autorise 3 jours/semaine...",
  "sources": ["Convention_RH_2024.pdf"],
  "confidence": 0.97
}
Authentification

Sécurisé par token Bearer

Toutes les requêtes API sont authentifiées via un token Bearer. Gérez vos clés depuis la console Akorbit avec des niveaux de permissions granulaires.

1
Créez votre compte

Inscrivez-vous sur platform.akorbit.com et accédez à votre espace développeur.

2
Générez une clé API

Créez une clé API avec les permissions adaptées à votre cas d'usage.

3
Intégrez en quelques lignes

Utilisez nos SDKs ou appelez directement l'API REST depuis votre application.

En-tête d'autorisation
Authorization: Bearer ak_live_••••••••••••••••••••••••••••••••
Niveaux de permissions
Lecture read
Interroger les collections et récupérer des réponses
Ingestion ingest
Uploader et indexer des documents et vecteurs
Agents agents
Créer, configurer et exécuter des agents IA
Administration admin
Gérer les utilisateurs, collections et paramètres
Endpoints

Les endpoints principaux

Une API cohérente et documentée pour tous vos besoins : ingestion de documents, RAG, agents IA, Text-to-SQL et workflows.

POST /documents/ingest Ingestion Ingérer et indexer un document
Corps de la requête (multipart/form-data)
file         → rapport_Q3.pdf
collection_id→ "col_finance_001"
ocr          → true
language     → "fr"
Réponse
{
  "document_id": "doc_8f2a...",
  "status": "indexed",
  "chunks": 142,
  "ocr_applied": true
}
POST /vectors/ingest Ingestion Ingérer des embeddings vectoriels
Corps de la requête (JSON)
{
  "collection_id": "col_rh_001",
  "vectors": [{
    "id": "chunk_001",
    "embedding": [0.12, 0.87, ...],
    "text": "Article 3 — Durée du contrat : 12 mois",
    "metadata": {"source": "doc.pdf"}
  }]
}
Réponse
{
  "inserted": 48,
  "collection_id": "col_rh_001",
  "status": "success"
}
POST /chat/query RAG Interroger une collection en RAG
Corps de la requête
{
  "collection_id": "col_finance_001",
  "query": "Quelle est la marge nette du T3 ?",
  "top_k": 5,
  "stream": false
}
Réponse
{
  "answer": "La marge nette T3 est de 18,4%...",
  "sources": [{
    "file": "Rapport_Q3.pdf",
    "page": 12,
    "score": 0.94
  }]
}
POST /agents/{agent_id}/query Agents Exécuter un agent IA sur une requête
Corps de la requête
{
  "query": "Quelle est ma politique de congés ?",
  "user_id": "user_482",
  "session_id": "sess_abc123",
  "stream": false
}
Réponse
{
  "answer": "Selon la convention RH 2024, vous avez droit à...",
  "agent_id": "ag_rh_001",
  "sources": ["Convention_RH.pdf"],
  "confidence": 0.97
}
POST /sql/query Text-to-SQL Convertir une question en SQL et exécuter
Corps de la requête
{
  "datasource_id": "db_erp_001",
  "query": "Top 5 produits par CA ce trimestre ?",
  "execute": true
}
Réponse
{
  "sql": "SELECT name, SUM(amount)...",
  "results": [{"name":"Alice",...}],
  "rows": 5
}
POST /workflows/{workflow_id}/run Workflow Déclencher un workflow automatisé
Corps de la requête
{
  "input": {
    "document_url": "https://...",
    "action": "summarize_and_tag"
  }
}
Réponse
{
  "run_id": "run_7d9f...",
  "status": "running",
  "webhook_url": "https://..."
}
Cas d'usage

Ce que vous pouvez construire

Chatbot documentaire

Intégrez un assistant IA dans votre intranet ou vos outils internes.

  • Réponses sourcées depuis vos documents
  • Support multi-langue
  • Historique des conversations

Agent IA métier

Créez des agents spécialisés pour RH, finance, support ou commercial.

  • Accès à vos systèmes internes
  • Actions automatiques déclenchées
  • Escalade vers un humain si nécessaire

Pipeline documentaire

Automatisez l'extraction, la classification et l'indexation de documents.

  • OCR automatique
  • Classification par catégorie
  • Notification en temps réel

Automation de workflows

Déclenchez des workflows complexes depuis vos événements métier.

  • Déclencheurs webhooks
  • Chaînes de traitements séquentiels
  • Logs et monitoring

Analyse de données

Connectez vos entrepôts de données et interrogez-les en langage naturel.

  • SQL généré automatiquement
  • Résultats en JSON structuré
  • Compatible tous les entrepôts SQL

Intégration produit

Embarquez l'IA d'Akorbit directement dans votre produit SaaS.

  • White-labeling disponible
  • Rate limiting par utilisateur
  • Dashboard analytics intégré
SDKs

Intégrez dans votre langage favori

Python
SDK officiel
JavaScript
Node.js / Browser
PHP
SDK officiel
REST / cURL
Compatible tous langages
Accéder à la documentation complète

Prêt à intégrer l'IA dans votre produit ?

Obtenez votre clé API et commencez à construire en quelques minutes.

Obtenir une clé API Voir la documentation
Clé API disponible immédiatement
Documentation interactive
SDKs Python, JS, PHP
Support développeur dédié