Tempo de leitura: 5 minutos
Plataforma de frota
Mobile App

Crie integrações personalizadas
com a API Zeo

Conecte seus sistemas ao Zeo com nossa API RESTful. Crie rotas,
Acompanhe o progresso em tempo real e automatize fluxos de trabalho com webhooks.

API e Webhooks do Zeo, Planejador de Rotas do Zeo
  • 99.9%

    SLA de disponibilidade da API

  • 100ms

    Tempo médio de resposta

  • 20+

    Endpoints API

  • 10K

    Limite de solicitações por minuto

Plataforma do desenvolvedor Características

Tudo o que você precisa para integrar o planejamento de rotas em seus aplicativos.

  • API e Webhooks do Zeo, Planejador de Rotas do Zeo

    API REST

    API RESTful completa para gerenciar rotas, paradas, motoristas e muito mais. Formato de solicitação/resposta JSON com documentação abrangente.

    • Criar e otimizar rotas programaticamente
    • Gerenciar paradas, motoristas e veículos.
    • Recuperar dados de rastreamento em tempo real
    • Acesse análises e relatórios.
    • Suporte para operações em massa
  • API e Webhooks do Zeo, Planejador de Rotas do Zeo

    Eventos de Webhook

    Receba notificações de eventos em tempo real nos seus endpoints. Reaja instantaneamente a mudanças de rota, interrupções e atualizações de drivers.

    • Eventos de início/conclusão de rota
    • Interromper notificações de alteração de status
    • Atualizações de localização do motorista
    • Alertas de alteração de ETA
  • API e Webhooks do Zeo, Planejador de Rotas do Zeo

    Autenticação

    Acesso seguro à API com autenticação padrão do setor. Vários tipos de chave para diferentes níveis de acesso e casos de uso.

    • autenticação por token de portador
    • Painel de gerenciamento de chaves de API
    • Permissões definidas por chave
    • Suporte de rotação chave
    • Limitação de taxa por chave
  • API e Webhooks do Zeo, Planejador de Rotas do Zeo

    Importação de terceiros

    Importe pedidos e trabalhos de sistemas externos sem complicações. Validação automática de endereços e geocodificação na importação.

    • endpoint de parada em massa de importação
    • Validação de endereço e geocodificação
    • Mapeamento de campo personalizado
    • Detecção duplicada
    • Rastreamento do status de importação

webhook Eventos

Inscreva-se para receber notificações de eventos em tempo real e reaja instantaneamente às mudanças de rota.

  • Quadro 1707478314 20 1, Planejador de Rotas Zeo

    rota.iniciada

    Acionado quando um motorista inicia a navegação em uma rota. Inclui o ID da rota, informações do motorista e tempo estimado de conclusão.

  • Quadro 1707478314 19, Planejador de Rota Zeo

    parar.concluído

    Acionado quando uma parada é marcada como concluída. Contém dados de comprovação de serviço, registros de data e hora e anotações.

  • Quadro 1707478314 17, Planejador de Rota Zeo

    parar.falhou

    Enviado quando uma parada não pôde ser concluída. Inclui o motivo da falha e quaisquer fotos/anotações capturadas.

  • Grupo 11880, Planejador de Rota Zeo

    driver.location_update

    Atualizações periódicas de localização para motoristas ativos. Frequência configurável de 30 segundos a intervalos de 5 minutos.

  • Grupo 11880 1, Planejador de Rota Zeo

    eta.alterado

    Acionado quando os horários estimados de chegada mudam significativamente devido ao trânsito ou atrasos.

  • Grupo 11880 2, Planejador de Rota Zeo

    rota.concluída

    Acionado quando todas as paradas forem concluídas. Inclui estatísticas finais, duração e métricas de desempenho.

  • // Exemplo de payload de webhook
    {
      "evento": "parar.concluído",
      "carimbo de data/hora": "2024-01-15T14:32:00Z",
      "dados": {
        "id_da_rota": "rota_abc123",
        "stop_id": "stop_xyz789",
        "motorista": {
          "eu ia": "drv_456",
          "nome": "John Smith"
        },
        "concluído_em": "2024-01-15T14:31:45Z",
        "prova": {
          "assinatura": "https://...",
          "fotos": ["https://..."],
          "notas": "Deixado na porta"
        } } }

    Terminais de API Visão geral

    Pontos finais essenciais para o planejamento de rotas e gerenciamento de frotas

    POST
    /v1/rotas

    Crie uma nova rota com paradas e configurações de otimização.

    ENTRE
    /v1/rotas/{id}

    Recupere os detalhes da rota, incluindo a sequência otimizada.

    POST
    /v1/rotas/{id}/otimizar

    Reotimizar uma rota existente com parâmetros atualizados

    ENTRE
    /v1/rotas/{id}/rastreamento

    Obtenha dados de rastreamento em tempo real para rotas ativas.

    POST
    /v1/paradas/importação

    A importação em massa é interrompida a partir de sistemas externos.

    PUT
    /v1/paradas/{id}/status

    Atualizar status da parada (concluída, falha, ignorada)

    ENTRE
    /v1/drivers

    Liste todos os motoristas com status de disponibilidade.

    ENTRE
    /v1/drivers/{id}/localização

    Obtenha a localização atual e o progresso da rota.

    POST
    /v1/webhooks

    Registre o endpoint do webhook para notificações de eventos.

    Code Exemplos

    Comece rapidamente com exemplos no seu idioma favorito.



    # Crie e otimize uma rota com várias paradas
    enrolar -X POSTAR "https://api.zeoroute.com/v1/routes" -H "Autorização: Portador $ZEO_API_KEY" -H "Content-Type: application/json" -d '{ "name": "Entregas Matinais", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "123 Warehouse St, City" }, "stops": [ { "address": "456 Customer Ave", "time_window": {"start": "09:00", "end": "12:00"}, "service_time": 15 }, { "address": "789 Business Blvd", "priority": "high", "service_time": 30 } ] }'
    
    # Obter detalhes da rota
    curl -X GET "https://api.zeoroute.com/v1/routes/route_abc123" -H "Autorização: Portador $ZEO_API_KEY"
    
    # Atualizar status de parada
    enrolar -X COLOCAR "https://api.zeoroute.com/v1/stops/stop_xyz789/status" -H "Autorização: Portador $ZEO_API_KEY" -H "Content-Type: application/json" -d '{"status": "concluído", "notas": "Deixado na porta"}'

    Integração Casos de uso

    As atualizações automatizadas funcionam para qualquer setor com visitas agendadas.

    ENTREGA

    Integração de gerenciamento de pedidos

    Uma plataforma de e-commerce importa automaticamente novos pedidos via API a cada hora. Os pedidos são agrupados por região, otimizados em rotas e despachados para os motoristas. Notificações via webhook atualizam o status do pedido em tempo real à medida que as entregas são concluídas.

    SERVIÇO DE CAMPO

    Agendamento de serviços orientado por CRM

    Uma empresa de serviços de campo sincroniza ordens de serviço do seu CRM via API. Novos trabalhos criam automaticamente paradas com detalhes do cliente, requisitos de serviço e janelas de tempo. Webhooks de conclusão atualizam o CRM e acionam o faturamento.

    Grupo 1707478361, Planejador de Rota Zeo

    Pronto para construir Sua integração?

    Obtenha sua chave de API e comece a desenvolver em minutos com nossa documentação completa.

    Grupo 1707478363, Planejador de Rota Zeo

    Questionário Zéo

    Perguntas
    Perguntei
    Frequentes

    Saber Mais

    API e Webhooks do Zeo

    Quais são os limites de taxa da API?

    As chaves de API padrão permitem 1,000 solicitações por minuto. Os planos empresariais podem solicitar limites maiores, de até 10,000 solicitações por minuto. Os cabeçalhos de limite de taxa são incluídos em todas as respostas para que você possa monitorar seu uso.

    Como faço para autenticar solicitações de API?

    Todas as solicitações de API exigem um token Bearer no cabeçalho de Autorização. Você pode gerar chaves de API nas configurações da sua conta. As chaves podem ser definidas para permissões específicas (somente leitura, gravação, administrador) e endereços IP.

    Vocês têm SDKs para diferentes linguagens?

    Oferecemos SDKs oficiais para JavaScript/Node.js e Python. SDKs mantidos pela comunidade estão disponíveis para Ruby, PHP e Go. Todos os SDKs são de código aberto e estão disponíveis no GitHub.

    Como funcionam as novas tentativas de webhook?

    Se o seu endpoint retornar uma resposta diferente de 2xx, tentaremos novamente com um intervalo de espera exponencial: 1 minuto, 5 minutos, 30 minutos, 2 horas e 24 horas. Após 5 tentativas falhas, o webhook será marcado como falho e você será notificado por e-mail.

    Existe algum ambiente de teste (sandbox)?

    Sim, oferecemos um ambiente sandbox completo em api-sandbox.zeoroute.com. O sandbox possui a mesma API, mas com dados de teste e sem custos. Perfeito para desenvolvimento e testes de integração.

    A API está disponível em todos os planos?

    A API REST da Zeo está disponível nos planos Fleet Management e Enterprise. Ela inclui gerenciamento completo de rotas, operações de parada, gerenciamento de motoristas e suporte a webhooks para notificações de eventos em tempo real.

    zeo Blogues

    Explore nosso blog para artigos interessantes, conselhos de especialistas e conteúdo inspirador que o mantém informado.

    23/01/2026 Como reduzir o tempo de deslocamento para inspeção - Destaque: Planejador de Rotas Zeo

    Como reduzir o tempo de deslocamento para inspeção e aumentar a eficiência da frota

    Tempo de leitura: 7 minutosAprenda estratégias comprovadas para reduzir o tempo de deslocamento para inspeções da sua frota. Otimize o agendamento, a coordenação móvel e o roteamento para reduzir os custos com tempo de inatividade.

    23/01/2026 Como gerenciar várias rotas de serviço de piscina (Destaque: Planejador de Rotas Zeo)

    Como gerenciar várias rotas de serviço de piscina de forma eficiente

    Tempo de leitura: 8 minutosAprenda estratégias comprovadas para gerenciar múltiplas rotas de serviço de piscinas, reduzir o tempo de deslocamento em 30%, eliminar limpezas perdidas e expandir de forma lucrativa para novas áreas.

    Como se tornar um motorista da DoorDash?, Planejador de rotas Zeo

    Como se tornar um motorista da DoorDash?

    Tempo de leitura: 4 minutosQuando se trata de trabalho, todos esperamos flexibilidade e liberdade. A explosão da economia gig é uma verdadeira prova disso.