Nomes alternativos dos check-ins
Os endereços ec_checkin e eccheckin, equivalentes a checkins, usados pelos apps de representantes já instalados.
O app de representantes antigo chama o check-in de ec_checkin (nome da Venddor 1.0) ou eccheckin (nome do app, sem sublinhado), no lugar de checkins. Os endereços desta página executam o mesmo código de Check-ins de visita: mesmo corpo, mesma resposta, mesmos erros.
Valem os mesmos avisos: route_id e manager_id são texto no JSON, e a forma /api (sem versão) pode trocar o route_id pelo id de outro registro. Prefira /api/v1.0. Todos exigem um usuário administrador.
/api/v1.0/ec_checkinAdminMesmo que checkins (POST), forma com versão
Igual a POST /api/v1.0/checkins. Responde 201 quando grava.
Corpo da requisição
route_idstringobrigatóriomanager_idstringobrigatóriolatitudenumberobrigatóriolongitudenumberobrigatórionotesstring/api/v1.0/ec_checkin/{manager_id}AdminMesmo que checkins (GET), forma com versão
Igual a GET /api/v1.0/checkins/{manager_id}: até 500 check-ins do representante, do mais novo para o mais antigo.
Parâmetros de caminho
manager_idstringobrigatório/api/ec_checkinAdminMesmo que checkins (POST), forma sem versão
Igual a POST /api/checkins. Responde 201 quando grava.
Corpo da requisição
route_idstringobrigatóriomanager_idstringobrigatóriolatitudenumberobrigatóriolongitudenumberobrigatórionotesstring/api/ec_checkin/{manager_id}AdminMesmo que checkins (GET), forma sem versão
Igual a GET /api/checkins/{manager_id}: até 500 check-ins do representante, do mais novo para o mais antigo.
Parâmetros de caminho
manager_idstringobrigatório/api/v1.0/eccheckinAdminMesmo que checkins (POST), forma com versão
Igual a POST /api/v1.0/checkins. Responde 201 quando grava.
Corpo da requisição
route_idstringobrigatóriomanager_idstringobrigatóriolatitudenumberobrigatóriolongitudenumberobrigatórionotesstring/api/v1.0/eccheckin/{manager_id}AdminMesmo que checkins (GET), forma com versão
Igual a GET /api/v1.0/checkins/{manager_id}: até 500 check-ins do representante, do mais novo para o mais antigo.
Parâmetros de caminho
manager_idstringobrigatório/api/eccheckinAdminMesmo que checkins (POST), forma sem versão
Igual a POST /api/checkins. Responde 201 quando grava.
Corpo da requisição
route_idstringobrigatóriomanager_idstringobrigatóriolatitudenumberobrigatóriolongitudenumberobrigatórionotesstring/api/eccheckin/{manager_id}AdminMesmo que checkins (GET), forma sem versão
Igual a GET /api/checkins/{manager_id}: até 500 check-ins do representante, do mais novo para o mais antigo.
Parâmetros de caminho
manager_idstringobrigatórioExemplo de requisição
curl -X POST "$BASE_URL/api/v1.0/ec_checkin" \
-u "$ADMIN_EMAIL:$API_KEY" \
-H "Content-Type: application/json" \
-d '{"route_id":"2","manager_id":"2","latitude":-23.5614,"longitude":-46.6559}'
curl "$BASE_URL/api/v1.0/eccheckin/2" -u "$ADMIN_EMAIL:$API_KEY"Resposta
{ "success": true, "checkin_id": 14 }A lista de check-ins tem o mesmo formato descrito em Check-ins de visita.
Erros
Os mesmos de Check-ins de visita: 400 para corpo inválido, rota inexistente ou de outro representante e coordenadas zeradas; 401 sem credencial; 403 para quem não é administrador; 500 Query failed quando o manager_id do caminho não é número.