Saltar al contenido principal
GET

Descargar un fichero de un documento entrante

Scope:inbox:inbox.read
https://api.holded.com/api/v2/inbox/{incomingDocumentId}/files/{filename}/download

Returns 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

incomingDocumentIdstringobligatorio

ID del documento entrante (ObjectId hexadecimal de 24 caracteres)

filenamestringobligatorio

Nombre del fichero a descargar

Parámetros de consulta

variantstringopcional= download

Modo 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-stream
string<binary>

Respuestas de error

401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
404Documento o fichero no encontradoapplication/json
429Límite de solicitudes excedidoapplication/json