Níveis de Serviço (SLA)

Disponibilidade

A apuração usa o mês civil e exclui manutenções programadas avisadas com 48 horas de antecedência e indisponibilidade causada por fatores fora do nosso controle.

Não atingida a meta em planos pagos, o Cliente pode solicitar crédito proporcional no ciclo seguinte, em até 30 dias do fim do mês apurado, escrevendo para contato@valordeveiculo.com.

Atualização dos dados

A Tabela FIPE é publicada mensalmente pela sua titular, em data que não controlamos. Nossa carga inicia assim que a nova edição aparece e publicamos após a validação — normalmente em até 72 horas da publicação da fonte.

• Enquanto o mês novo não é publicado, a API continua servindo o último mês validado, e o campo reference de toda resposta diz qual é.
• Carga que não passa na validação não é publicada. É preferível servir o mês anterior íntegro a servir o mês novo pela metade.
• GET /v1/tables lista os meses disponíveis para o seu plano.

Versionamento e depreciação

A API é versionada no caminho (/v1). Dentro de uma versão, só fazemos mudanças compatíveis: adicionar campo na resposta ou parâmetro opcional. Remover ou renomear campo, mudar tipo ou alterar semântica exige versão nova.

Depreciação de versão é anunciada com 12 meses de antecedência, por e-mail e no header Deprecation das respostas.

Limites operacionais

• Cota e limite por segundo conforme o plano, informados nos headers de cada resposta.
• 402 em cota esgotada e 429 em excesso de requisições por segundo — nunca cobrança silenciosa de excedente.
• Respostas de catálogo e de mês fechado são cacheáveis; respeite o Cache-Control para não gastar cota com consulta repetida.