GET
Descargar un fichero de un documento entrante
Scope:
inbox:inbox.readhttps://api.holded.com/api/v2/inbox/{incomingDocumentId}/files/{filename}/downloadReturns the raw content of a file attached to an incoming document. Use `?variant=inline` to display the file in-browser with 24-hour caching instead of triggering a download.
Parámetros
Parámetros de ruta
incomingDocumentId
stringobligatorioID del documento entrante (ObjectId hexadecimal de 24 caracteres)
filename
stringobligatorioNombre del fichero a descargar
Parámetros de consulta
variant
stringopcional= downloadModo de entrega: download (adjunto) o inline (visualización con caché)
"download""inline"Petición
python
import requests
url = "https://api.holded.com/api/v2/inbox/507f1f77bcf86cd799439011/files/document.pdf/download?variant=download"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respuestas
Respuesta
json
"string"Respuestas exitosas
200Contenido del ficheroapplication/octet-streamstring<binary>
Respuestas de error
401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json404Documento o fichero no encontradoapplication/json429Límite de solicitudes excedidoapplication/json