La API de Bentho
Pregúntale a los documentos de un espacio, sube y quita documentos, ajusta cómo responde y consulta tus créditos. Todo por HTTP, con JSON y una clave. Los módulos de tu espacio suman sus propias rutas.
Lo básico
| BASE | https://bentho.org/api |
|---|---|
| CLAVE | Authorization: Bearer bth_<id>.<secreto> · Claves y permisos |
| FORMATO | JSON (Content-Type: application/json), salvo la subida de documentos (multipart) y el stream (SSE). |
| DESDE DÓNDE | Desde tu servidor. La API no admite llamadas desde el navegador de tus usuarios (CORS), y la clave nunca debe llegar ahí. |
| VERSIÓN | v1: se agregan campos, nunca se quitan ni se renombran. |
Las rutas
| MÉTODO | RUTA | PARA QUÉ | PERMISO |
|---|---|---|---|
| POST | /rag/{espacio}/conversations | Haz una pregunta a tu espacio | lee |
| SSE | /rag/{espacio}/conversations/stream | La misma pregunta, en vivo | lee |
| GET | /rag/{espacio}/documents | Los documentos del espacio | lee |
| POST | /rag/{espacio}/load_documents | Sube documentos | escribe |
| DEL | /rag/{espacio}/documents/{archivo} | Quita un documento | escribe |
| GET | /rag/{espacio}/indexing_status | ¿Ya está listo lo que subí? | lee |
| PATCH | /rag/{espacio}/config | Ajusta cómo responde el Cerebro | escribe |
| PATCH | /companies/{espacio}/api-config | Límites, cuota diaria e IPs del espacio | escribe |
| GET | /cuentas/{cuenta}/bolsa | Tus créditos | lee |
Módulos
Las rutas de un módulo cuelgan de /api/mod/{modulo}/{espacio}/, con la misma clave y los mismos límites. Solo responden en los espacios que tienen ese módulo (los ves en GET /api/companies); en los demás, 403.
Fuentes · /api/mod/fuentes/{espacio}
| MÉTODO | RUTA | PARA QUÉ | PERMISO |
|---|---|---|---|
| POST | /fichas | Arma una ficha | escribe |
| GET | /fichas/{ficha} | El estado de una ficha | lee |
| GET | /fichas/{ficha}/markdown | La ficha armada y cómo se armó | lee |
| GET | /fichas | Las fichas del espacio | lee |
| POST | /fuentes | Crea una fuente | escribe |
| POST | /fuentes/{fuente}/lanzar | Lanza una fuente | escribe |
| GET | /fuentes/{fuente} | Una fuente y su última corrida | lee |
| GET | /fuentes | Las fuentes del espacio | lee |
| POST | /fuentes/{fuente}/cancelar | Cancela la corrida de una fuente | escribe |
| DEL | /fuentes/{fuente} | Borra una fuente | escribe |
Landings · /api/mod/landing/{espacio}
| MÉTODO | RUTA | PARA QUÉ | PERMISO |
|---|---|---|---|
| POST | /landings | Crea una landing | escribe |
| GET | /landings | Las landings del espacio | lee |
| GET | /landings/{landing} | El estado de una landing | lee |
| GET | /landings/{landing}/html | El HTML de una landing | lee |
| POST | /landings/{landing}/completar | Responde a lo que falta | escribe |
| POST | /landings/{landing}/refinar | Pide cambios a una landing | escribe |
| POST | /landings/{landing}/validar | Valida un HTML editado a mano | escribe |
| POST | /landings/{landing}/cancelar | Cancela la versión en curso | escribe |
| DEL | /landings/{landing} | Borra una landing | escribe |
Otras rutas útiles
GET /api/companies: los espacios a los que llega tu clave, con suidy sus módulos.GET /api/companies/{espacio}/cuenta: la cuenta del espacio (para consultar la bolsa de créditos).GET /api/rag/{espacio}/documents/{archivo}: descarga un documento.DELETE /api/rag/{espacio}/clear_cache: vacía la caché de respuestas del espacio (escribe)./api/tokens: crear, listar y revocar claves. Ver Claves y permisos.