Reenviar una Assembly Notification
https://api2.transloadit.com/assembly_notifications/{ASSEMBLY_ID}/replayassemblies:write.Reenvía una Assembly Notification al enviar nuevamente la solicitud POST que contiene el
JSON con el resultado de la Assembly a la notify_url que se especificó cuando se creó la
Assembly.
Campos de POST
- Es obligatorio incluir
signature. Para obtener más información, consulta Signature Authentication. - Es obligatorio incluir
params. Debe contener un objeto codificado en JSON con las claves que se muestran en la siguiente tabla.
Claves admitidas en el campo params
auth— obligatorioobjectContiene, como mínimo, tu Auth Key de Transloadit en la propiedad
key.Si habilitas Signature Authentication, también debes establecer una fecha de vencimiento para la solicitud en la propiedad expires:
{ "key": "23c96d084c744219a2ce156772ec3211", "expires": "2009-08-28T01:02:03.000Z" }Recomendamos encarecidamente incluir la propiedad
nonce: un valor único generado aleatoriamente para cada solicitud que evita el procesamiento duplicado durante los reintentos, puede ayudar con la depuración y evita vectores de ataque como la reutilización de claves de firma:{ // … "nonce": "04ac6cb6-df43-41fb-a7fd-e5dd711a64e1" }La propiedad
refereres una expresión regular que se compara con el referente HTTP de esta subida, como"example\.org". Especifica esta clave para asegurarte de que las subidas solo procedan de tu dominio.Las subidas sin referente siempre pasarán la comprobación, ya que algunos navegadores lo desactivan, por lo que esto solo resulta útil en unos pocos casos de uso. Para obtener detalles sobre las expresiones regulares, consulta la documentación de RegExp de Mozilla.
La propiedad
max_sizepuede utilizarse para establecer el tamaño máximo en bytes de una subida, como1048576(1 MB). Especifícalo para impedir que los usuarios suban archivos excesivamente grandes. El tamaño de los archivos se comprueba en cuanto comienza la subida. Si supera el tamaño máximo, se cancela todo el proceso de subida y la Assembly genera un error, aunque contenga archivos que no superen el límite demax_size. Si solo quieres ignorar los archivos que superen cierto tamaño y procesar todos los demás, usa 🤖/file/filter.La propiedad
max_number_of_filespuede utilizarse para establecer la cantidad máxima de archivos que puede contener una subida, como100. Especifícalo para impedir que los usuarios suban una cantidad excesiva de archivos, tanto mediante subidas de archivos como mediante Robots de importación.Estas propiedades pueden establecerse como parte de la solicitud de la Assembly o como parte del Template.
stepsRecord<string, object & object>Contiene Assembly Instructions.
waitboolean(valor predeterminado:true)Si se proporciona con el valor
false, la solicitud a la API se devolverá de inmediato aunque la Notification siga en curso. Esto puede ser útil si tu servidor tarda en responder, pero no quieres que la solicitud a la API para reenviar la notificación quede bloqueada.
Respuesta
Este es un ejemplo del cuerpo de la respuesta:
{
"ok": "ASSEMBLY_REPLAYING"
}Devuelve el código de éxito
ASSEMBLY_NOTIFICATION_REPLAYED o el código de error
correspondiente con los detalles de lo que salió mal.
Si waitForEncoding se estableció en false, el código de éxito será ASSEMBLY_NOTIFICATION_REPLAYING.