Documentación de la API del Agente de Insight Profundo
v1 · Autenticación básica + envío de transcripciones + lectura de análisis
Autenticación
Todos los endpoints /api/v1/* requieren incluir la clave de API en la cabecera de la solicitud:
Authorization: Bearer lj_live_xxxxxxxxxxxxxxxx
La clave de API se crea en /settings/api-keys.
POST /api/v1/transcripts
Envía texto transcrito (aplicable a: dispositivos de hardware, webhooks de herramientas de grabación de terceros)
Solicitud
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"
}'Respuesta
{
"transcript_id": "550e8400-e29b-41d4-a716-446655440000",
"analysis_id": null,
"message": "转写已保存"
}GET /api/v1/analyses
Lista los análisis recientes de la org (50 registros)
curl https://lengjing.zaowuyun.com/api/v1/analyses \ -H "Authorization: Bearer lj_live_xxxxxxxx"
GET /api/v1/analyses?id=xxx
Obtiene los detalles del análisis (incluidos los anclajes de evidencia)
curl "https://lengjing.zaowuyun.com/api/v1/analyses?id=ANALYSIS_ID" \ -H "Authorization: Bearer lj_live_xxxxxxxx"
Límite de frecuencia
60 solicitudes por minuto / clave de API (al superarlo se devuelve 429)
Permisos (scopes)
transcript.write— Enviar transcripcionesanalysis.read— Leer análisis*— Todos
Códigos de error
| Código de estado | Significado |
|---|---|
| 401 | Clave no válida / revocada |
| 403 | La clave carece de los permisos necesarios |
| 404 | El recurso no existe |
| 429 | Límite de frecuencia |
| 500 | Error del servicio |
Soporte
Comentarios y problemas: hi@zaowuyun.com