Skip to main content

​
Descripción

Este endpoint te permite refrescar la URL de un recurso multimedia, generando una URL firmada temporal. Es útil cuando la URL ha expirado.

​
Endpoint

POST https://api.jelou.ai/v1/external/assets/refresh

​
Autenticación

​
Authorization
string
required
Autenticación Basic con credenciales codificadas en Base64. Formato: Basic <Base64(clientId:clientSecret)>

​
Cuerpo de la Solicitud

​
resourceUrl
string
required
URL del recurso que deseas refrescar. Debe ser una URL válida HTTPS.
​
ttl
integer
required
Tiempo de vida de la URL firmada en segundos. Valor mínimo: 900 (15 minutos). Valor máximo: 3600 (1 hora).

​
Ejemplo de Solicitud

cURL
curl --request POST \
  --url https://api.jelou.ai/v1/external/assets/refresh \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "resourceUrl": "https://cdn.example.com/media/documento-confidencial.pdf",
    "ttl": 900
  }'

​
Respuesta

​
signedUrl
string
URL firmada temporal que permite acceso público al recurso durante el tiempo especificado en ttl.

​
Ejemplo de Respuesta Exitosa

200 - OK
{
  "signedUrl": "https://cdn.example.com/media/a1b2c3d4e5f6/assets/documento-confidencial.pdf?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9jZG4uZXhhbXBsZS5jb20vbWVkaWEvYTFiMmMzZDRlNWY2L2Fzc2V0cy9kb2N1bWVudG8tY29uZmlkZW5jaWFsLnBkZiIsIkNvbmRpdGlvbiI6eyJEYXRlTGVzc1RoYW4iOnsiQVdTOkVwb2NoVGltZSI6MTczNDU2Nzg5MH19fV19&Key-Pair-Id=APKAEXAMPLEKEY&Signature=abc123XYZ~signature-example-9876543210abcdef"
}

​
Errores

422 - Unprocessable Entity
{
  "data": {
    "message": "Resolved credential object is not valid"
  },
  "message": [
    "Signed URL error."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1126",
    "key": "SIGNED_URL_ERROR",
    "description": "Signed URL error.",
    "developerMessages": {
      "es": "No se pudo generar el URL firmado.",
      "en": "Signed URL error.",
      "pt": "Não foi possível gerar o URL firmado."
    },
    "clientMessages": {
      "es": "No se pudo generar el URL firmado.",
      "en": "Signed URL error.",
      "pt": "Não foi possível gerar o URL firmado."
    }
  }
}
500 - Internal Server Error
{
  "message": [
    "We are having trouble processing your request. Please try again later."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E0000",
    "key": "UNKNOWN_ERROR",
    "description": "Error to be thrown when it couldn't be determined the reason of failure",
    "developerMessages": {
      "es": "Error inesperado occurido, revisar logs.",
      "en": "Unexpected error occurred, check logs."
    },
    "clientMessages": {
      "es": "Estamos teniendo problemas procesando la solicitud. Por favor intenta mas tarde.",
      "en": "We are having trouble processing your request. Please try again later."
    }
  }
}

​
Códigos de Estado HTTP

CódigoDescripción
200URL firmada generada exitosamente
422Error de procesamiento - no se pudo generar la URL firmada
500Error interno del servidor