GET
/api/rag/{espacio}/documents/{archivo}Descarga un documento
El archivo tal como lo subiste. La respuesta es el archivo, no JSON.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
Los nombres, en GET documents.
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). |
| archivo | string | SÍ | El nombre exacto, como sale en GET documents, codificado para URL. Sin «/», «\» ni «..». |
RESPUESTA 200
200 con el archivo en el cuerpo. Las cabeceras que importan:
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| Content-Type | cabecera | application/pdf para los PDF; text/plain para el resto, también .docx. |
| Content-Disposition | cabecera | attachment, sin nombre: ponle tú el nombre al guardarlo. |
| Cache-Control | cabecera | no-store. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 400 | Nombre con barras, puntos o vacío | nombre de archivo no válido. |
| 404 | No existe o no es .pdf, .docx, .txt ni .md | Documento no encontrado: <archivo> |
| 502 | El servicio no respondió: reintenta con espera creciente | — |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Codifica el nombre: «manual de usuario.pdf» va como
manual%20de%20usuario.pdf. - Un .docx llega como
text/plainpero con sus bytes de siempre: guárdalo con su extensión.