Saltar al contenido principal

Recuperar una actividad

GEThttps://carchost.fieldcontrol.com.br/tasks/{id}

Devuelve una actividad por el identificador. Para crear o modificar, use Actividades de la orden.

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

Solicitud​

Parámetros de ruta

idstringobligatorio

Identificador de la actividad.

Ejemplo: ZTllZjFiNzUtOGQ3MS00ZmE1LWFjNmUtYzlmNGQ1YzJiOWI3OjIyOTE1.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Respuestas

  • 200

    Actividad encontrada. Si el identificador es válido pero la actividad no existe, la respuesta es 200 con cuerpo vacío.

  • 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

    Identificador del path inválido o de otra cuenta (uriValidationErr), o parámetro de query inválido (parametersValidationErr). Un identificador válido que no existe devuelve 404.

  • 429

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

  • 500

    Error inesperado en el servidor.