# Cobli API Documentation > Documentation for Cobli API ## Tutoriais: Documentation - [Documentation](https://docs.cobli.co/docs.md): Cobli API documentation ## Documentação: Cobli REST API - [Listar configurações de alertas](https://docs.cobli.co/reference/listtriggers.md): Lista todas as configurações de alertas da frota com filtros opcionais. Esta consulta retorna as configurações (regras) de alertas cadastradas, e não os alertas (eventos) disparados por elas. - [Buscar configuração de alerta por ID](https://docs.cobli.co/reference/gettriggerbyid.md): Busca uma configuração de alerta específica pelo seu ID único. Retorna a configuração (regra) cadastrada, e não os alertas (eventos) disparados por ela. - [Criar uma nova configuração de alerta](https://docs.cobli.co/reference/createtrigger.md): Cria uma nova configuração de alerta para monitoramento e notificações. A configuração define quando e para quais veículos os alertas (eventos) serão disparados. Há **dois modelos mutuamente… - [Atualizar uma configuração de alerta existente](https://docs.cobli.co/reference/updatetrigger.md): Atualiza uma configuração de alerta existente identificada pelo triggerId. Há **dois modelos mutuamente exclusivos** — envie os campos de **apenas um**: - **Legado:** `condition_id` + `days_of_week`… - [Ativar ou desativar uma configuração de alerta](https://docs.cobli.co/reference/settriggeractive.md): Liga ou desliga uma configuração de alerta existente sem alterar seus demais atributos. Quando ativa, a configuração passa a disparar alertas (eventos); quando inativa, deixa de dispará-los. O corpo… - [Listar eventos de alertas](https://docs.cobli.co/reference/listtriggersevents.md): Lista, de forma paginada, os eventos gerados pelos alertas da frota no período informado. Obrigatórios: `startTime`, `endTime` e **exatamente um** entre `ruleId` ou `eventId` (informar ambos resulta… - [Listar tipos de alertas disponíveis para configuração](https://docs.cobli.co/reference/listeventsandrules.md): Lista os tipos de alertas (eventos e suas regras) disponíveis para configuração na frota. O resultado descreve cada tipo de alerta e as condições que podem ser parametrizadas ao criar uma… - [Lista associações de cartões combustíveis](https://docs.cobli.co/reference/getassociations.md): Lista todas as associações de cartões combustíveis com filtro opcional Com esse endpoint você pode: - Obter uma lista com todas as associações de cartão combustível, podendo filtrá-la somente para… - [Recuperar Associações de cartão combustível](https://docs.cobli.co/reference/associationactivate.md): Recupera associações de cartões combustíveis excluídos Com esse endpoint você pode: - Recuperar a associação de um cartão combustível, reativando-o no painel. - [Excluir Associação de cartão combustível](https://docs.cobli.co/reference/associationdeactivate.md): Exclui associações de cartões combustíveis ativos Com esse endpoint você pode: - Excluir cartões combustível que não fazem mais parte da sua frota, ocultando-os no painel. - [Consultar todas as checklists](https://docs.cobli.co/reference/checklists-get.md): Rota usada para consulta todas as checklists já cadastradas da frota. Com esse endpoint você pode: - Saber quais itens do checklist estão marcados, seus respectivos valores e opções. - Saber o… - [Criar checklist](https://docs.cobli.co/reference/checklists-post.md): Rota usada para adicionar uma nova checklist em uma frota - [Consultar nomes de todas as checklists](https://docs.cobli.co/reference/checklists-name-get.md): Rota usada para consulta do nome de todas as checklists já cadastradas da frota. Com esse endpoint você pode: - Listar os nomes de todas as checklists da sua frota - [Consultar checklist](https://docs.cobli.co/reference/checklistschecklistid-get.md): Rota usada para consultar uma checklist através de seu ID Com esse endpoint você pode: - Obter todas as checklists da sua frota. - Saber quais itens do checklist estão marcados, seus… - [Alterar checklist](https://docs.cobli.co/reference/checklistschecklistid-put.md): Rota usada para alterar uma checklist através de seu ID - [Deletar checklist](https://docs.cobli.co/reference/checklistschecklistid-delete.md): Rota usada para deletar uma checklist através de seu ID - [Consultar todas as checklists preenchidas](https://docs.cobli.co/reference/checklists-completed-get.md): Rota usada para consultar todas as checklists já preenchidas da frota. Com esse endpoint você pode: - Obter todas as checklists preenchidas da sua frota. - Saber quais itens do checklist estão… - [Ativar/Desativar checklist](https://docs.cobli.co/reference/activatechecklist.md): Rota usada para ativar ou desativar uma checklist em uma frota (o motorista não conseguirá mais preencher checklists desativadas) - [Consultar todas as checklists template](https://docs.cobli.co/reference/checkliststemplateget.md): Rota usada para consultar todas as checklists template da frota. Com esse endpoint você pode: - Obter todas as checklists template da sua frota. - Saber quando e por quem a checklist foi criada. - [Consultar comprovantes](https://docs.cobli.co/reference/pocs-get.md): Retorna todos os comprovantes enviados pelos motoristas da frota. Com esse endpoint você pode: - Obter uma lista com todos os comprovantes da sua frota. - Saber a data em que os comprovantes… - [Cria despesa](https://docs.cobli.co/reference/createexpense.md) - [Atualizar despesa](https://docs.cobli.co/reference/updateexpense.md) - [Remover despesa](https://docs.cobli.co/reference/deleteexpense.md) - [Lista o histórico de despesas](https://docs.cobli.co/reference/expenseshistory.md) - [Lista despesas agrupadas por veículo](https://docs.cobli.co/reference/vehicleexpenses.md) - [Consultar multa](https://docs.cobli.co/reference/getfine.md) - [Listar multas](https://docs.cobli.co/reference/listfines.md): Multas da frota no período, paginadas. Filtros, busca e ordenação são aplicados no servidor. Se a frota não contratou o módulo de multas, ou se o usuário só enxerga grupos sem multas, a lista volta… - [Lista de dispositivos](https://docs.cobli.co/reference/devices.md): Lista todos os dispositivos ```Beta``` Com esse endpoint você pode: - Obter uma lista paginada e pronta para consumo, de todos os dispositivos da sua frota. - Saber qual veículo está associado… - [Buscar dispositivo](https://docs.cobli.co/reference/device_by_id.md): Retorna o dispositivo com id igual ao passado na variável da url ```Beta``` Com esse endpoint você pode: - Saber qual veículo está associado ao dispositivo. - Obter um facilitador de… - [Sugestão de informação do veículo pelo número de chassi ou placa](https://docs.cobli.co/reference/vehiclesuggestionvin-get.md): Consulta as informações de montadora, modelo, ano, entre outras informações, de um veículo com base no número de chassi ou placa Com esse endpoint você pode: - Obter dados sugeridos sobre o… - [Buscar dispositivo](https://docs.cobli.co/reference/get_device_by_esn.md): Busca o dispositivo passado por parâmetro associado a frota do usuário. Contendo informações do veículo, do motorista associado e da última localização válida. Com esse endpoint você pode: - Saber… - [Lista o preço das manutenções](https://docs.cobli.co/reference/listmaintenancecosts.md) - [Gastos de combustível](https://docs.cobli.co/reference/costsfuel.md): Consulta os gastos de combustível para todos os veículos da frota usando parâmetros de url para definir o período de tempo desejado. Não é possível requisitar dados para mais de 90 dias de uma única… - [Gastos de combustível e manutenção em Excel](https://docs.cobli.co/reference/costsreport.md): Consulta os gastos de combustível e manutenção para todos os veículos da frota usando parâmetros de url para definir o período de tempo desejado. Não é possível requisitar dados para mais de 90 dias… - [Transações de Combustível](https://docs.cobli.co/reference/transactionget.md): **Deprecado:** Essa rota está deprecada e será removida em 11/05/2026. Use informações oferecidas pela rota paginada de [transações de combustível](/reference/transactions_list) para obter as… - [Importar transação de combustível](https://docs.cobli.co/reference/transactionpost.md): Importa uma nova transação de combustível. Com esse endpoint você pode: - Importar nova transação de combustível sem a necessidade de possuir uma associação de cartão combustível. - Anexar… - [Lista de Transações de Combustível Paginada](https://docs.cobli.co/reference/transactions_list.md): Lista paginada e pronta para consumo de Transações de combustível processadas. Com este endpoint você pode: - Obter uma lista paginada com todas as transações de combustível processadas da sua frota,… - [Edita transação de combustível](https://docs.cobli.co/reference/transactionput.md): Edita uma transação de combustível existente a partir de seu ID de referência. - [Relatório de Transações](https://docs.cobli.co/reference/transactionsreport.md): Gera um relatório das transações de combustível da sua frota. Com esse endpoint você pode: - Exportar um relatório com informações detalhadas das transações processadas no período de tempo… - [Lista de grupos paginada](https://docs.cobli.co/reference/groups.md): Lista todos os grupos de veículos da frota ```Beta``` Com esse endpoint você pode: - Obter uma lista com todos os grupos da sua frota. - Identificar todos os veículos pertencentes a cada grupo… - [Criar grupo com veículos associados](https://docs.cobli.co/reference/create_group.md): Cria um grupo com o nome passado e associa os veículos informados à ele ```Beta``` - [Buscar grupo de veículo](https://docs.cobli.co/reference/group_by_id.md): Retorna o grupo de veículo com id igual ao passado na variável da url ```Beta``` Com esse endpoint você pode: - Identificar todos os veículos pertencente ao grupo selecionado. - [Associar veículo ao grupo](https://docs.cobli.co/reference/vehicle_group_association.md): Associa um veículo ao grupo com id igual ao passado na variável da url ```Beta``` - [Desassociar veículo do grupo](https://docs.cobli.co/reference/vehicle_group_desassociation.md): Desassocia veículo do grupo com id igual ao passado na variável da url ```Beta``` - [Lista de locais de interesse paginada](https://docs.cobli.co/reference/list_geofences.md): Lista todos os locais de interesse da frota ```Beta``` Com esse endpoint você pode: - Obter uma lista com todos os locais de interesse da sua frota. - [Criar local de interesse](https://docs.cobli.co/reference/create_geofences.md): Cria um local de interesse ```Beta``` Com esse endpoint você pode: - Criar um novo local de interesse. - [Buscar local de interesse](https://docs.cobli.co/reference/get_geofences_by_id.md): Retorna o local de interesse com id igual ao passado na variável da url ```Beta``` Com esse endpoint você pode: - Buscar um local de interesse por ID. - [Atualizar local de interesse](https://docs.cobli.co/reference/put_geofences_by_id.md): Atualiza o local de interesse com id igual ao passado na variável da url ```Beta``` Com esse endpoint você pode: - Atualizar um local de interesse por ID. - [Apagar local de interesse](https://docs.cobli.co/reference/delete_geofences_by_id.md): Apaga um local de interesse com id igual ao passado na variável da url ```Beta``` Com esse endpoint você pode: - Apagar um local de interesse por ID. - [Histórico de manutenções](https://docs.cobli.co/reference/maintenancemaintenancespast-get.md): Consulta todas as manutenções já cadastradas da frota. Com esse endpoint você pode: - Saber o histórico de manutenções da sua frota. - Saber o histórico de manutenções por veículo. - [Status dos avisos de manutenção](https://docs.cobli.co/reference/maintenancemaintenancesupcoming-get.md): Consulta todos os avisos de manutenção e os divide em 3 diferentes status (onTime, warning, delayed) representando a urgência dos mesmos. Com esse endpoint você pode: - Saber o estado das… - [Lista os registros de manutenção](https://docs.cobli.co/reference/listmaintenances.md) - [Extrai relatório de manutenção](https://docs.cobli.co/reference/reportmaintenance.md) - [Cria um registro de manutenção - V1](https://docs.cobli.co/reference/createmaintenance.md): **AVISO DE MIGRAÇÃO**: Esta é a versão 1.0 da API de criação de manutenção. Esta versão v1 será descontinuada em 02/03/2026. Recomendamos planejar a migração para a v2 o quanto antes:… - [Cria um registro de manutenção - V2](https://docs.cobli.co/reference/createmaintenancev2.md) - [Edita um registro de manutenção](https://docs.cobli.co/reference/updatemaintenance.md) - [Deleta um registro de manutenção](https://docs.cobli.co/reference/deletemaintenance.md) - [Lista as peças](https://docs.cobli.co/reference/listparts.md) - [Cria uma peça](https://docs.cobli.co/reference/createpart.md) - [Atualiza uma peça](https://docs.cobli.co/reference/updatepart.md) - [Deleta uma peça](https://docs.cobli.co/reference/deletepart.md) - [Lista os lembretes](https://docs.cobli.co/reference/listreminders.md) - [Cria um lembrete - V1](https://docs.cobli.co/reference/createreminder.md): **AVISO DE MIGRAÇÃO**: Esta é a versão 1.0 da API de criação de lembretes de manutenção. Esta versão v1 será descontinuada em 02/03/2026. Recomendamos planejar a migração para a v2 o quanto antes.… - [Atualiza um lembrete](https://docs.cobli.co/reference/updatereminder.md) - [Deleta um lembrete](https://docs.cobli.co/reference/deletereminder.md) - [Cria um lembrete - V2](https://docs.cobli.co/reference/createreminderv2.md) - [Eventos de risco da frota](https://docs.cobli.co/reference/riskevents.md): Acompanhe os detalhes dos eventos de risco da sua frota de forma granular evento a evento. Com esse endpoint você pode: - Obter data e hora do evento. - Obter localização precisa de onde… - [Ranking de condução](https://docs.cobli.co/reference/rankingsafety.md): Acompanhe o score por veículo ou motorista da frota, baseado em um cálculo que considera os eventos de risco, de acordo com o peso estipulado pela frota. Com esse endpoint você pode: - Obter o… - [Buscar telemetria do dispositivo](https://docs.cobli.co/reference/telemetry.md): Retorna os dados de telemetria do dispositivo com id igual ao passado na variável da url ```Beta``` Com esse endpoint você pode: - Obter os dados de telemetria do dispositivo selecionado. -… - [Previsão de chegada de um dispositivo](https://docs.cobli.co/reference/device_eta.md): Retorna distância, duração e tráfego da rota do dispositivo desejado. Necessita de coordenadas de latitude e longitude do destino, ou o seu endereço completo. Caso ambos os dados sejam enviados, as… - [Geração da página de acompanhamento do veículo](https://docs.cobli.co/reference/eta.md): Gera o acompanhamento em tempo real do veículo. A página gerada expira após um período de tempo: - Se o veículo não chegou ao local de destino dentro de 24 horas a partir do momento em que a página… - [Lista de dispositivos com telemetria [Old]](https://docs.cobli.co/reference/list_devices.md): Lista os dispositivos associados a frota do usuário. Contendo informações do veículo, do motorista associado e da última localização válida. Com esse endpoint você pode: - Obter todos os… - [Buscar histórico de passagem](https://docs.cobli.co/reference/locations_history.md): Acompanhe todos os veículos que passaram por um endereço em uma data específica. Com esse endpoint, você pode: - Saber cada veículo que realizou uma passagem em um endereço específico, dentro de um… - [Lista de Motoristas](https://docs.cobli.co/reference/drivers_list.md): Lista todos os motoristas ativos de forma paginada Com esse endpoint você pode: - Obter uma lista paginada e pronta para consumo de todos os motoristas ativos da sua frota. - Saber informações… - [Buscar motorista](https://docs.cobli.co/reference/driver_by_id.md): Retorna o motorista com id igual ao passado na variável da url ```Beta``` Com esse endpoint você pode: - Saber informações de nome e telefone do motorista. - Saber se ele está ativo e seu… - [Excluir Motorista](https://docs.cobli.co/reference/delete_driver.md): Exclui um motorista da frota. A exclusão também desassocia automaticamente qualquer veículo ou chaveiro que estava associado ao motorista. - [Autenticar o código do motorista](https://docs.cobli.co/reference/authenticate_driver_code.md): Valida o código do motorista. Usado em logins de motoristas no aplicativo da Cobli. - [Associar um veículo a um motorista](https://docs.cobli.co/reference/assign_driver.md): Associa um motorista a um veículo. Ao tentar associar um motorista já associado a outro veículo o resultado será um erro. Primeiro é necessário desassociá-lo do veículo anterior usando a rota de… - [Desassociar um veículo a um motorista](https://docs.cobli.co/reference/unassing_drivers.md): Desassocia um motorista a um veículo. - [Criar Motoristas](https://docs.cobli.co/reference/create_drivers.md): Criar motorista na frota. - [Criar Motoristas em Massa](https://docs.cobli.co/reference/create_drivers_batch.md): Criar motorista em massa de uma frota. - [Atualizar informações do motorista](https://docs.cobli.co/reference/update_drivers.md): Atualiza as informações cadastrais do motorista. Sendo necessário enviar todos os campos e não só os campos que tiveram mudanças. Caso não tenha em mãos todas as informações do motorista a ser… - [Obter um link temporário para uma mídia](https://docs.cobli.co/reference/media_view.md): Gera um link temporário de 5 minutos para uma mídia. Ao expirar a validade do link, deverá ser solicitado um novo link para visualização da mesma mídia. Ao solicitar uma mídia com identificador… - [Obter uma lista de mídias da frota](https://docs.cobli.co/reference/media_list.md): Retorna uma lista de mídias da frota de Cobli Cam. Essas mídias podem ser filtradas de acordo com os parâmetros. - [Paradas de motoristas](https://docs.cobli.co/reference/statsstopsdriver.md): **Deprecado:** Essa rota está deprecada e será removida em 01/10/2023. Use informações oferecidas pela rota de [trajetos e paradas](/reference/paths-1) para obter as informações desejadas. Consulta… - [Paradas de veículos](https://docs.cobli.co/reference/statsstopsvehicle.md): **Deprecado:** Essa rota está deprecada e será removida em 01/10/2023. Use informações oferecidas pela rota de [trajetos e paradas](/reference/paths-1) para obter as informações desejadas. Consulta… - [Viagens de motoristas](https://docs.cobli.co/reference/statstripsdriver.md): **Deprecado:** Essa rota está deprecada e será removida em 01/10/2023. Use informações oferecidas pela rota de [trajetos e paradas](/reference/paths-1) para obter as informações desejadas. Consulta… - [Viagens de veículos](https://docs.cobli.co/reference/statstripsvehicle.md): **Deprecado:** Essa rota está deprecada e será removida em 01/10/2023. Use informações oferecidas pela rota de [trajetos e paradas](/reference/paths-1) para obter as informações desejadas. Consulta… - [Jornadas de motoristas](https://docs.cobli.co/reference/statsjourneydriver.md): **Deprecado:** Essa rota está deprecada e será removida em 01/10/2023. Use informações oferecidas pela rota de [trajetos e paradas](/reference/paths-1) para obter as informações desejadas. Consulta… - [Jornadas de veículos](https://docs.cobli.co/reference/statsjourneyvehicle.md): **Deprecado:** Essa rota está deprecada e será removida em 01/10/2023. Use informações oferecidas pela rota de [trajetos e paradas](/reference/paths-1) para obter as informações desejadas. Consulta… - [Relatório de trajetos e paradas](https://docs.cobli.co/reference/tripsandstops.md): Acesse os dados de trajetos e paradas individuais da sua frota. Com esse endpoint, você pode: - Visualizar cada trajeto e parada individualmente por veículo e motorista; - Extrair informações como… - [Relatório de trajetos e paradas por veículo](https://docs.cobli.co/reference/tripsandstopsvehicle.md): Acompanhe os dados consolidados de trajetos e paradas dos veículos da sua frota. Com esse endpoint, você pode: - Extrair informações de distância percorrida e tempo dirigido por veículo; - Extrair… - [Relatório diário de trajetos e paradas por veículo](https://docs.cobli.co/reference/tripsandstopsvehicledaily.md): Acompanhe os dados de trajetos e paradas dos veículos da sua frota agrupados por dia. Com esse endpoint, você pode: - Extrair informações diárias de distância percorrida e tempo dirigido por veículo;… - [Relatório de trajetos e paradas por motorista](https://docs.cobli.co/reference/tripsandstopsdriver.md): Acompanhe os dados consolidados de trajetos e paradas dos motoristas da sua frota. Com esse endpoint, você pode: - Extrair informações de distância percorrida e tempo dirigido por motorista; -… - [Relatório diário de trajetos e paradas por motorista](https://docs.cobli.co/reference/tripsandstopsdriverdaily.md): Acompanhe os dados de trajetos e paradas dos motoristas da sua frota agrupados por dia. Com esse endpoint, você pode: - Extrair informações diárias de distância percorrida e tempo dirigido por… - [Relatório de Dispositivos Removidos](https://docs.cobli.co/reference/statsincidentsreport.md): Gera um arquivo xlsx com as informações de dispositivos removidos e recolocados usando parâmetros de url para definir o período de tempo desejado. Não é possível requisitar dados para mais de 90 dias… - [Relatório de Performance dos Motoristas](https://docs.cobli.co/reference/statsperformancedriverreport.md): **Deprecado:** Essa rota está deprecada e será removida em 15/11/2023. Use informações oferecidas pela rota de [trajetos e paradas](/reference/paths-1). O relatório em xlsx pode ser exportado pelo… - [Relatório de Performance dos Veículos](https://docs.cobli.co/reference/statsperformancevehiclereport.md): **Deprecado:** Essa rota está deprecada e será removida em 15/11/2023. Use informações oferecidas pela rota de [trajetos e paradas](/reference/paths-1). O relatório em xlsx pode ser exportado pelo… - [Relatório de ponto a ponto](https://docs.cobli.co/reference/statsreportspathsvehicles.md): Gera um arquivo xlsx com as informações de onde o veículo passou a cada intervalo de minutos definido. Tenha visibilidade da rota percorrida e da velocidade em cada ponto. Não é possível requisitar… - [Relatório de atividade fora do horário de trabalho por veículo](https://docs.cobli.co/reference/statsreportsout-of-workvehicle.md): Gera um arquivo xlsx com as informações de veículos que rodaram em horários fora da jornada de trabalho Maior controle de hora extra e de gasto de combustível. Não é possível requisitar dados para… - [Relatório de atividade fora do horário de trabalho por motorista](https://docs.cobli.co/reference/statsreportsout-of-workdriver.md): Gera um arquivo xlsx com as informações de motoristas que rodaram em horários fora da jornada de trabalho Maior controle de hora extra e de gasto de combustível. Não é possível requisitar dados para… - [Histórico de associação entre motoristas e veículos filtrado por motoristas](https://docs.cobli.co/reference/listdrivervehicleassociationhistorybydriver.md): Um relatório de associação entre motoristas e veículos filtrados por motoristas. Com este endpoint você pode: - Obter dados de que motorista estava associado a qual veículo em determinado período. -… - [Histórico de associação entre motoristas e veículos filtrado por veículos](https://docs.cobli.co/reference/listdrivervehicleassociationhistorybyvehicle.md): Um relatório de associação entre motoristas e veículos filtrados por veículos. Com este endpoint você pode: - Obter dados de que veículo estava associado a qual motorista em determinado período. -… - [Distância Percorrida](https://docs.cobli.co/reference/distance-driven.md): Maior controle para estimar gastos de manutenção e combustível. Com esse endpoint você pode: - Obter uma lista, paginada e pronta para consumo, com os dados de distância percorrida por todos os… - [Motor ocioso agregado por veículo](https://docs.cobli.co/reference/listvehicleidleengine.md): Melhore a eficiência da sua frota e pense políticas de frota que gerem economia. Com este endpoint você pode: - Obter uma lista com os dados de motor ocioso de todos os veículos da sua frota. -… - [Motor ocioso agregado por motorista](https://docs.cobli.co/reference/listdriveridleengine.md): Melhore a eficiência da sua frota e pense políticas de frota que gerem economia. Com este endpoint você pode: - Obter uma lista com os dados de motor ocioso de todos os motoristas da sua frota. -… - [Eventos de motor ocioso do veículo](https://docs.cobli.co/reference/listvehicleidleengineevents.md): Investigue a fundo os eventos de motor ocioso da sua frota, por veículo. Com este endpoint você pode: - Obter uma lista pronta para consumo de todos os eventos de motor ocioso gerados por um veículo;… - [Eventos de motor ocioso do motorista](https://docs.cobli.co/reference/listdriveridleengineevents.md): Investigue a fundo os eventos de motor ocioso da sua frota, por condutor. Com este endpoint você pode: - Obter uma lista pronta para consumo de todos os eventos de motor ocioso gerados por um… - [Atividade em locais de interesse](https://docs.cobli.co/reference/listgeofenceevents.md): Investigue a fundo os atividade em locais de interesse da sua frota, por veículo. Com este endpoint você pode: - Obter uma lista pronta para consumo de todas atividades em locais de interesse gerados… - [Eventos de segurança agregados por motorista](https://docs.cobli.co/reference/listdriversafety.md): Obtenha uma visão resumida do desempenho de cada motorista de sua frota em relação à segurança. Com este endpoint você pode: - Definir para qual período e quais motoristas quer obter dados. -… - [Eventos de segurança agregados por veículo](https://docs.cobli.co/reference/listvehiclesafety.md): Obtenha uma visão resumida do desempenho de cada veículo de sua frota em relação à segurança. Com este endpoint você pode: - Definir para qual período e quais veículos quer obter dados. - Escolher… - [Relatório de condução econômica](https://docs.cobli.co/reference/economicdriving.md): Acompanhe o comportamento de condução dos seus motoristas em um relatório que utiliza dados precisos da rede can do veículo, com esse relatório você pode: - Extrair informações de distância… - [Obstrução de câmera agregada por veículo](https://docs.cobli.co/reference/listcameraobstruction.md): Obtenha uma visão resumida do nível de obstrução das câmeras instaladas nos veículos da sua frota. Com este endpoint você pode: - Definir para qual período e quais veículos quer obter dados. - Obter… - [Criar rotas](https://docs.cobli.co/reference/createroutes.md): ![Beta](https://img.shields.io/badge/status-beta-yellow) Crie rotas para os seus serviços e entregas. - [Consultar rotas](https://docs.cobli.co/reference/getroutes.md): ![Beta](https://img.shields.io/badge/status-beta-yellow) Consulte as rotas criadas para os seus serviços e entregas. - [Editar rota](https://docs.cobli.co/reference/updateroute.md): ![Beta](https://img.shields.io/badge/status-beta-yellow) Edite as rotas para os seus serviços e entregas. - [Deletar rotas](https://docs.cobli.co/reference/deleteroutes.md): ![Beta](https://img.shields.io/badge/status-beta-yellow) Delete rotas. - [Consultar rota por ID](https://docs.cobli.co/reference/getroutebyid.md): ![Beta](https://img.shields.io/badge/status-beta-yellow) Consulte uma rota específica de serviços e entregas pelo seu identificador. O `routeId` corresponde ao `id` retornado pelo endpoint de… - [Detalhes de trajetos e paradas](https://docs.cobli.co/reference/paths.md): Acompanhe todos os dados de trajetos e paradas da sua frota. Com esse endpoint, você pode: - Saber cada trajeto e parada que o veículo fez, com os endereços iniciais e finais; - Saber o tempo parado… - [Detalhes do trajeto do dispositivo](https://docs.cobli.co/reference/device_trip.md): Mostra detalhes do trajeto de um dispositivo em uma janela de tempo. Contém informações como: - Dados do dispositivo - Dados do veículo - Motoristas envolvidos - Informações de telemetria do… - [Dados de trajetos e paradas](https://docs.cobli.co/reference/pathssummary.md): Acompanhe todos os dados de trajetos e paradas da sua frota. Com esse endpoint, você pode: - Saber o endereço inicial e final de cada veículo no período determinado agrupado por dia, semana ou ano. -… - [Eventos de velocidade da via da frota](https://docs.cobli.co/reference/roadspeedevents.md): Acompanhe os detalhes dos eventos de velocidade da via da sua frota de forma granular evento a evento. Com esse endpoint você pode: - Saber a data e hora do evento. - Obter detalhes de onde… - [Eventos de velocidade do veículo da frota](https://docs.cobli.co/reference/vehiclespeedevents.md): Acompanhe os detalhes dos eventos de velocidade do veículo da sua frota de forma granular evento a evento. Com esse endpoint você pode: - Saber a data e hora do evento. - Obter detalhes de onde… - [Criar veículo](https://docs.cobli.co/reference/createvehicle.md): Cria um veículo na frota - [Lista de veículos](https://docs.cobli.co/reference/vehicles.md): Lista todos os veículos da frota ```Beta``` Com esse endpoint você pode: - Obter uma lista, paginada e pronta para consumo, dos veículos da sua frota. - Obter informações do veículo, como… - [Criar veículos em lote](https://docs.cobli.co/reference/createvehiclebatch.md): Cria múltiplos veículos na frota em uma única requisição. Com esse endpoint você pode: - Criar vários veículos de uma só vez, otimizando o processo de cadastro. - Definir informações básicas… - [Atualizar veículos em lote](https://docs.cobli.co/reference/updatevehiclebatch.md): Atualiza múltiplos veículos da frota em uma única requisição. Com esse endpoint você pode: - Atualizar vários veículos de uma só vez, otimizando o processo de edição. - Atualizar informações… - [Buscar veículo](https://docs.cobli.co/reference/vehicle_by_id.md): Retorna o veículo com id igual ao passado na variável da url ```Beta``` Com esse endpoint você pode: - Obter informações do veículo, como modelo, ano, placa, etc. - Saber a qual dispositivo o… - [Edição de dados do veículo](https://docs.cobli.co/reference/vehicle.md): Atualiza os dados de um veículo, sendo necessário enviar somente os campos que tiveram mudanças. Com esse endpoint você pode: - Atualizar os dados de marca, modelo, ano e tamanho do veículo. -… - [Associação de veículos e dispositivos](https://docs.cobli.co/reference/vehicle_device_association.md): Associa um dispositivo ao veículo. Com esse endpoint você pode associar um dispositivo ainda não associado a um veículo que esteja sem dispositivo. - [Desassociação de veículos e dispositivos](https://docs.cobli.co/reference/vehicle_device_dissociation.md): Desassocia um dispositivo do veículo. Com esse endpoint você pode desassociar um dispositivo de um veículo. - [Buscar Odômetro](https://docs.cobli.co/reference/publicv1vehiclesvehicleidodometer-get.md): Retorna dados do odômetro do veículo com id passado na variável da url ```Beta``` Com esse endpoint você pode: - Obter os dados de odômetro do veículo selecionado na data escolhida. > Os dados… - [Cadastrar Odômetro](https://docs.cobli.co/reference/publicv1vehiclesvehicleidodometer-post.md): Cadastra o odômetro atual do veículo com id passado na variável da url ```Beta``` - [Buscar dados CAN do veículo](https://docs.cobli.co/reference/vehicle-can.md): Retorna os dados CAN (Controller Area Network) para um veículo específico ```Beta``` Com esse endpoint você pode: - Obter dados de telemetria avançada provenientes da rede CAN do veículo. -… - [Lista usuários da frota](https://docs.cobli.co/reference/herbie-11dashfleetfleetidusers-get.md): Retorna a lista de usuários da frota. ## Documentação: Webhooks - [Histórico das entregas de webhook](https://docs.cobli.co/reference/listwebhookeventsv2.md): Consulte o histórico das entregas de webhook feitas pela Cobli para a sua frota, incluindo o payload de cada evento e os metadados da entrega (URL, status HTTP, retentativas, timestamp). Use este… - [geofence_in — Veículo entrou em um ponto de interesse](https://docs.cobli.co/reference/webhookgeofencein.md): Disparado na **entrada** de um ponto de interesse cadastrado na frota. O ponto cruzado vem em `geofenceId`, `name` e `address`. Veículos sem posição válida no instante do cruzamento não geram o… - [geofence_out — Veículo saiu de um ponto de interesse](https://docs.cobli.co/reference/webhookgeofenceout.md): Disparado na **saída** de um ponto de interesse cadastrado na frota. O ponto cruzado vem em `geofenceId`, `name` e `address`. Veículos sem posição válida no instante do cruzamento não geram o… - [ignition_on — Ignição ligada](https://docs.cobli.co/reference/webhookignitionon.md): Disparado na transição do estado da ignição para **ligada**. O campo `ignition` do payload traz o estado resultante (`"ON"`). `driverId` é incluído quando um motorista está identificado no veículo… - [ignition_off — Ignição desligada](https://docs.cobli.co/reference/webhookignitionoff.md): Disparado na transição do estado da ignição para **desligada**. O campo `ignition` do payload traz o estado resultante (`"OFF"`). `driverId` é incluído quando um motorista está identificado no… - [position — Posição periódica com ignição ligada](https://docs.cobli.co/reference/webhookposition.md): Posição periódica do veículo com a ignição **ligada**. ### Janelamento de 3 minutos A Cobli **não** entrega cada ping GPS. Aplica-se uma janela de **3 minutos** por dispositivo: - O primeiro… - [position_sleep — Posição periódica com ignição desligada](https://docs.cobli.co/reference/webhookpositionsleep.md): Posição periódica do veículo com a ignição **desligada**. Com a ignição desligada, `speedInKmh` é omitido e `rpm` vem como `null`. ### Janelamento de 3 minutos A Cobli **não** entrega cada ping… - [alert_driven_over_speed — Início de alerta de excesso de velocidade](https://docs.cobli.co/reference/webhookalertdrivenoverspeed.md): Disparado no **início** de um alerta de excesso de velocidade, quando o veículo ultrapassa o limite configurado. > **Assine o tipo `speed`.** Ele entrega automaticamente tanto >… - [end_alert_driven_over_speed — Fim de alerta de excesso de velocidade](https://docs.cobli.co/reference/webhookendalertdrivenoverspeed.md): Disparado quando o veículo volta ao limite de velocidade, fechando o `alert_driven_over_speed` correspondente e acrescentando a duração total da infração. > Correlacione o par pelo **`deviceId` +… - [battery_external_low — Tensão da bateria externa abaixo do threshold](https://docs.cobli.co/reference/webhookbatteryexternallow.md): Disparado quando a **tensão média** da bateria externa cai abaixo do threshold configurado para a frota. A média evita disparos espúrios em quedas instantâneas, como a partida do motor. O threshold… - [battery_external_disconnected — Bateria externa desconectada](https://docs.cobli.co/reference/webhookbatteryexternaldisconnected.md): Disparado quando a bateria externa é **desconectada** do dispositivo. Um `battery_external_disconnected` sem `battery_external_reconnected` na sequência costuma indicar violação do equipamento ou… - [battery_external_reconnected — Bateria externa reconectada](https://docs.cobli.co/reference/webhookbatteryexternalreconnected.md): Disparado quando a bateria externa é **reconectada** do dispositivo. Fecha o ciclo aberto por `battery_external_disconnected`. `batteryVoltage` traz a tensão lida na reconexão. --- Assine o tipo… - [hard_break — Frenagem brusca detectada pela câmera](https://docs.cobli.co/reference/webhookhardbreak.md): Disparado quando a câmera integrada Cobli detecta **frenagem brusca**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o comportamento detectado.… - [fast_acceleration — Aceleração brusca detectada pela câmera](https://docs.cobli.co/reference/webhookfastacceleration.md): Disparado quando a câmera integrada Cobli detecta **aceleração brusca**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o comportamento… - [speedy_turn — Curva acentuada detectada pela câmera](https://docs.cobli.co/reference/webhookspeedyturn.md): Disparado quando a câmera integrada Cobli detecta **curva acentuada**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o comportamento detectado.… - [tailgating — Seguimento próximo detectado pela câmera](https://docs.cobli.co/reference/webhooktailgating.md): Disparado quando a câmera integrada Cobli detecta **seguimento próximo do veículo à frente**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o… - [front_collision_warning — Aviso de colisão frontal detectado pela câmera](https://docs.cobli.co/reference/webhookfrontcollisionwarning.md): Disparado quando a câmera integrada Cobli detecta **risco de colisão frontal**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o comportamento… - [distracted_driving — Distração ao volante detectada pela câmera](https://docs.cobli.co/reference/webhookdistracteddriving.md): Disparado quando a câmera integrada Cobli detecta **distração do motorista ao volante**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o… - [eyes_closed — Olhos fechados detectados pela câmera](https://docs.cobli.co/reference/webhookeyesclosed.md): Disparado quando a câmera integrada Cobli detecta **olhos fechados do motorista**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o… - [phone_usage — Uso de celular detectado pela câmera](https://docs.cobli.co/reference/webhookphoneusage.md): Disparado quando a câmera integrada Cobli detecta **uso de celular ao volante**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o comportamento… - [smoking — Uso de cigarro detectado pela câmera](https://docs.cobli.co/reference/webhooksmoking.md): Disparado quando a câmera integrada Cobli detecta **uso de cigarro na cabine**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o comportamento… - [yawn — Bocejo detectado pela câmera](https://docs.cobli.co/reference/webhookyawn.md): Disparado quando a câmera integrada Cobli detecta **bocejo do motorista**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica o comportamento… - [sos — Sinal SOS acionado pelo motorista](https://docs.cobli.co/reference/webhooksos.md): Disparado quando a câmera integrada Cobli detecta **acionamento do botão de SOS pelo motorista**. Os 11 tipos de evento de câmera compartilham a mesma estrutura de payload — o `eventType` identifica… - [route_started — Motorista iniciou a rota](https://docs.cobli.co/reference/webhookroutestarted.md): Disparado quando o motorista **inicia** a rota no aplicativo. Traz apenas o bloco `route`; `route.outcome` ainda não existe neste momento. > **Assine o grupo `routes`** — plural, literalmente… - [route_finished — Rota encerrada](https://docs.cobli.co/reference/webhookroutefinished.md): Disparado quando a rota é **encerrada**, qualquer que seja o desfecho. O resultado está em `route.outcome`: | `outcome` | Significado | |-----------|-------------| | `EXECUTED` | Rota cumprida… - [activity_completed — Parada concluída](https://docs.cobli.co/reference/webhookactivitycompleted.md): Disparado quando uma parada é **concluída**, total ou parcialmente. `activity.outcome` distingue os dois casos — e `PARTIALLY_COMPLETED` **é conclusão, não falha**: falha é o tipo `activity_failed`,… - [activity_failed — Parada marcada como não realizada](https://docs.cobli.co/reference/webhookactivityfailed.md): Disparado quando uma parada é marcada como **não realizada**. `activity.outcome` e `activity.windowCompliance` **não aparecem** neste tipo — o próprio `eventType` já é o desfecho. >… - [ignition_lock_status_changed — Status da trava de ignição mudou](https://docs.cobli.co/reference/webhookignitionlockstatuschanged.md): Disparado quando o **status global** da trava de ignição do veículo muda. O `status` é derivado da combinação entre o valor desejado (configurado no app) e o valor reportado pelo dispositivo, e… - [allow_list_changed — Lista de motoristas autorizados mudou](https://docs.cobli.co/reference/webhookallowlistchanged.md): Disparado quando a **lista de motoristas autorizados** a operar o veículo muda — seja porque um motorista foi adicionado ou removido da configuração, seja porque o `status` global mudou (por exemplo,… ## Recipes - [Atividades em locais de interesse](https://docs.cobli.co/recipes/atividades-em-locais-de-interesse.md) - [Consultar endpoint com paginação](https://docs.cobli.co/recipes/consultar-endpoint-com-paginação.md) - [Criar um mapa interativo com dados de trajetos paradas](https://docs.cobli.co/recipes/criar-um-mapa-interativo-com-dados-de-trajetos-paradas.md) - [Edição de veículos em massa](https://docs.cobli.co/recipes/edição-de-veículos-em-massa.md) - [Extrair análise de motor ocioso por veículo](https://docs.cobli.co/recipes/extrair-análise-de-motor-ocioso-por-veículo.md) - [Extrair eventos de risco](https://docs.cobli.co/recipes/extrair-eventos-de-risco.md) - [Histórico de associação entre motorista e veículo](https://docs.cobli.co/recipes/histórico-de-associação-entre-motorista-e-veículo.md)