Saltar al contenido principal

Enviar un archivo

POSThttps://carchost.fieldcontrol.com.br/uploads

Primera etapa para adjuntar un archivo: devuelve el endpoint y los campos (form) para enviar el archivo en multipart/form-data. Después del envío, adjunte el archivo a la orden en Adjuntar un archivo a la orden, usando la URL del archivo enviado en path.

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

Solicitud​

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.

entityTypestringobligatorio

Dónde se adjuntará el archivo. Hoy solo order.

Valores aceptados: order.Mínimo de 2 caracteres.

entityIdstringobligatorio

Identificador de la orden de servicio.

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.

typestringobligatorio

Tipo MIME del archivo (p. ej. application/pdf, image/jpeg, video/mp4).

sizenumberobligatorio

Tamaño en bytes, hasta 50 MB.

De 0 a 52428800.

Respuestas

  • 201

    Datos para el envío, válidos por 20 minutos.

  • 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.

  • 422

    Cuerpo inválido (resourceValidationErr): entityType distinto de order, orden inválida, extensión o tipo no aceptados, o archivo de más de 50 MB.

  • 429

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

  • 500

    Error inesperado en el servidor.