Appearance
POST /v3/comandos/iniciou
Notifica a Maggu que o processamento de um comando foi iniciado e informa o total de registros que serão enviados. Deve ser chamado antes de enviar os lotes.
Requisição
POST /v3/comandos/{id}/iniciou
json
{
"totalDeRegistrosAEnviar": 1500
}| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | Sim | ID do comando em execução |
totalDeRegistrosAEnviar | number | Não | Quantidade total de registros que serão enviados (recomendado — permite diagnóstico de progresso) |
Implementação
python
session.post("api/v3/comandos/iniciou", json={"id": cmd["id"], "total": len(registros)})
for lote in chunk(registros, 400):
# envia os lotes normalmenteRespostas
| Código | Significado |
|---|---|
200 OK | Notificação registrada |
400 Bad Request | Corpo inválido |
403 Forbidden | Token inválido |
404 Not Found | Comando não encontrado |