Saltar al contenido
API v1 · https://bentho.org/api
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

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies).
archivostringSÍ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:

CAMPOTIPOQUÉ ES
Content-Typecabeceraapplication/pdf para los PDF; text/plain para el resto, también .docx.
Content-Dispositioncabeceraattachment, sin nombre: ponle tú el nombre al guardarlo.
Cache-Controlcabecerano-store.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUSCUÁNDODETAIL LITERAL
400Nombre con barras, puntos o vacíonombre de archivo no válido.
404No existe o no es .pdf, .docx, .txt ni .mdDocumento no encontrado: <archivo>
502El 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/plain pero con sus bytes de siempre: guárdalo con su extensión.