Saltar al contenido principal

Listar actividades

GEThttps://carchost.fieldcontrol.com.br/tasks

Lista las actividades de todas las órdenes de servicio de la cuenta, con paginación, filtros y ordenación.

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

Solicitud​

Parámetros de consulta

limitinteger

Cantidad de ítems por página.

De 1 a 100.Predeterminado: 10.

offsetinteger

Cantidad de ítems que se omiten.

De 0 a 200000.Predeterminado: 0.

qstring

Filtros en el formato campo:valor, separados por espacios (cómo filtrar). Los filtros aceptados están en la tabla de abajo.

Ejemplo: status:done completed_at>=:2026-10-01.

FiltroQué hace
order_id

Identificador de la orden de servicio.

status

Situación de la actividad (scheduled, in-progress, done, etc.).

employee_id

Identificador del colaborador responsable.

archived

true para archivadas, false para activas.

created_at

Fecha igual a la informada (ISO 8601, UTC).

created_at>=

Creadas a partir de la fecha informada, inclusive.

created_at<=

Creadas hasta la fecha informada, inclusive.

created_at>

Creadas después de la fecha informada.

created_at<

Creadas antes de la fecha informada.

updated_at

Fecha igual a la informada (ISO 8601, UTC).

updated_at>=

Modificadas a partir de la fecha informada, inclusive.

updated_at<=

Modificadas hasta la fecha informada, inclusive.

updated_at>

Modificadas después de la fecha informada.

updated_at<

Modificadas antes de la fecha informada.

completed_at

Fecha igual a la informada (ISO 8601, UTC).

completed_at>=

Concluidas a partir de la fecha informada, inclusive.

completed_at<=

Concluidas hasta la fecha informada, inclusive.

completed_at>

Concluidas después de la fecha informada.

completed_at<

Concluidas antes de la fecha informada.

scheduled_date

Fecha igual a la informada (ISO 8601, UTC).

scheduled_date>=

Programadas a partir de la fecha informada, inclusive.

scheduled_date<=

Programadas hasta la fecha informada, inclusive.

scheduled_date>

Programadas después de la fecha informada.

scheduled_date<

Programadas antes de la fecha informada.

sortstring

Ordenación. El prefijo - invierte el orden.

Valores aceptados: id, created_at, -created_at, updated_at, -updated_at, scheduled_date, -scheduled_date.Predeterminado: id.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Respuestas

  • 200

    Lista de actividades.

  • 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

    Filtro, paginación u ordenación inválidos (parametersValidationErr).

  • 429

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

  • 500

    Error inesperado en el servidor.