Media
Los archivos de una verificación no se sirven con tu API key. Se pide un enlace firmado, de vida corta, y ese enlace es el que puedes pasar a un navegador o guardar en un expediente.
La credencial del archivo es la firma de la URL, no la key: quien tenga el enlace ve el archivo hasta que caduque.
Emitir el enlace exige persons:read_pii y queda auditado.
Emitir un enlace firmado
POST /v1/media-links
Requiere una API key secreta (belfort_{env}_sk_…) con scope persons:read_pii.
Genera una URL de vida corta para un archivo de evidencia. Queda auditado: emitir el enlace es, a efectos de bitácora, acceder al archivo.
Cuerpo de la petición
| Campo | Requerido | Tipo | Descripción |
|---|---|---|---|
mediaAssetId |
sí | string |
|
purpose |
no | string | null |
|
reason |
no | string | null |
Respuestas
200 Successful Response — MediaLinkResponse
| Campo | Requerido | Tipo | Descripción |
|---|---|---|---|
assetId |
sí | string |
|
expiresAt |
sí | string (date-time) |
|
object |
no | "media_link" |
|
url |
sí | string |
Descargar un archivo firmado
GET /v1/media/{asset_id}
Requiere una API key secreta (belfort_{env}_sk_…).
Sirve los bytes de un archivo de evidencia. La credencial es la firma que viaja en la URL, no tu API key: si la firma no valida o el enlace caducó, responde 403.
Parámetros
asset_id path · requerido |
string |
token query · requerido |
string |
Respuestas
200 Successful Response