Adjuntar un archivo a la orden

POSThttps://carchost.fieldcontrol.com.br/orders/{id}/attachments

Adjunta a una orden de servicio un archivo ya enviado. La respuesta de éxito usa el estado 200.

Requiere los headers X-Api-Key, User-Agent y Content-Type: application/json. Límite: 1 solicitud por segundo (más información).

Solicitud

Parámetros de ruta

idstringobligatorio

Identificador de la orden de servicio.

Ejemplo: NDJiMWQ0YzQtOWNmOC00NWE2LTg2MjItYjNjNzZjZjk0MmM4OjIyOTE1.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Cuerpo de la solicitud

JSON, enviado con el header Content-Type: application/json.

pathstringobligatorio

URL del archivo.

Mínimo de 5 caracteres.

titlestringobligatorio

Nombre del archivo, con extensión: .pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx, .jpg, .jpeg, .heic, .webp, .png, .mp4, .avi, .mov, .kml, .txt, .csv, .xml o .zip.

Mínimo de 2 caracteres.

sizenumberobligatorio

Tamaño en bytes, hasta 50 MB.

De 0 a 52428800.

typestringobligatorio

Tipo MIME, por ejemplo application/pdf, image/jpeg, image/png, video/mp4, text/csv o application/zip. Los videos quedan en processing hasta que termina la compresión.

Respuestas

• 200

  Adjunto creado.

• 401

  Clave de API ausente (Missing API Key) o inválida (Invalid API Key). Consulte Autenticación.

• 403

  Cuenta bloqueada (Account blocked), vencida (Account expired) o con un plan que no permite integración (Account plan not allowed). Consulte Autenticación.

• 404

  Recurso no encontrado. El cuerpo de la respuesta está vacío.

• 422

  Cuerpo inválido (resourceValidationErr): extensión del title o type no aceptados, o size de más de 50 MB. Identificador de la orden inválido: uriValidationErr.

• 429

  Se superó el límite de 1 solicitud por segundo. Consulte Límite de solicitudes.

• 500

  Error inesperado en el servidor.