Documentation de l'API Agent d'Insight Profond
v1 · Authentification de base + envoi de transcriptions + lecture des analyses
Authentification
Toutes les interfaces /api/v1/* nécessitent une clé API dans l'en-tête de la requête :
Authorization: Bearer lj_live_xxxxxxxxxxxxxxxx
Les clés API se créent dans /settings/api-keys.
POST /api/v1/transcripts
Envoyer du texte transcrit (cas d'usage : appareils matériels, webhooks d'outils d'enregistrement tiers)
Requête
curl -X POST https://lengjing.zaowuyun.com/api/v1/transcripts \
-H "Authorization: Bearer lj_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"text": "说话人1: ...\n说话人2: ...",
"title": "周三战略会议",
"device_id": "meeting-room-shanghai-01"
}'Réponse
{
"transcript_id": "550e8400-e29b-41d4-a716-446655440000",
"analysis_id": null,
"message": "转写已保存"
}GET /api/v1/analyses
Lister les analyses récentes de l'org (50 éléments)
curl https://lengjing.zaowuyun.com/api/v1/analyses \ -H "Authorization: Bearer lj_live_xxxxxxxx"
GET /api/v1/analyses?id=xxx
Obtenir le détail d'une analyse (avec les ancres de preuves)
curl "https://lengjing.zaowuyun.com/api/v1/analyses?id=ANALYSIS_ID" \ -H "Authorization: Bearer lj_live_xxxxxxxx"
Limitation de débit
60 requêtes par minute / clé API (au-delà, renvoie 429)
Permissions (scopes)
transcript.write— Envoyer des transcriptionsanalysis.read— Lire les analyses*— Toutes
Codes d'erreur
| Code de statut | Signification |
|---|---|
| 401 | Clé invalide / révoquée |
| 403 | La clé n'a pas la permission requise |
| 404 | Ressource introuvable |
| 429 | Limitation de débit |
| 500 | Erreur du service |
Support
Signalement de problèmes :hi@zaowuyun.com