{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Uso Responsável da API","description":"APIs públicas da Movvia para parceiros, estabelecimentos comerciais e clientes de dados veiculares.","meta":[{"name":"theme-color","content":"#7E3DEE"},{"name":"apple-mobile-web-app-title","content":"Movvia Docs"},{"name":"application-name","content":"Movvia Docs"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"uso-responsável-da-api","__idx":0},"children":["Uso Responsável da API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As APIs Movvia processam dados veiculares, transações financeiras e imagens de passagem. O uso responsável protege os titulares de dados, garante a estabilidade do serviço para todos os clientes e mantém a conformidade regulatória."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"lgpd--proteção-de-dados","__idx":1},"children":["LGPD — proteção de dados"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Trate dados pessoais (placas, imagens, coordenadas) apenas para os fins previstos no contrato e na base legal documentada."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Não retenha dados além do prazo necessário para a finalidade declarada."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Atenda às solicitações de exclusão de titulares usando o endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE"]}," disponível na API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Documente suas operações de tratamento (RoPA) — a Movvia disponibiliza o template no onboarding."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Veja o guia completo em ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/compartilhado/lgpd"},"children":["LGPD"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"segurança-de-credenciais","__idx":2},"children":["Segurança de credenciais"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Armazene credenciais em variáveis de ambiente ou gerenciadores de segredos. Nunca as inclua em código-fonte ou repositórios."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Rotacione credenciais periodicamente e imediatamente em caso de comprometimento."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valide a assinatura HMAC-SHA256 em todos os webhooks recebidos antes de processar o payload."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Veja: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/compartilhado/seguranca/basic-auth"},"children":["Basic Auth"]}," e ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/compartilhado/seguranca/hmac"},"children":["HMAC"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rate-limits-e-consumo-consciente","__idx":3},"children":["Rate limits e consumo consciente"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implemente backoff exponencial em retentativas para não agravar situações de sobrecarga."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Não realize polling em alta frequência em endpoints que suportam webhooks — use os webhooks."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Se antecipar picos de volume (campanhas, migrações em lote), informe a Movvia com antecedência para ajuste de limites."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Veja: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/compartilhado/seguranca/rate-limits"},"children":["Rate Limits"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"idempotência","__idx":4},"children":["Idempotência"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use chaves de idempotência em todas as operações financeiras ou de escrita irreversível."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Em caso de timeout ou erro de rede, reenvie a mesma requisição com a mesma chave antes de criar uma nova operação."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Veja: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/compartilhado/seguranca/idempotencia"},"children":["Idempotência"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"versionamento-e-sunsets","__idx":5},"children":["Versionamento e sunsets"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monitore o ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/changelog"},"children":["Changelog"]}," para acompanhar mudanças de contrato."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ao receber notificação de sunset de uma versão de API, planeje a migração dentro da janela informada."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Não dependa de comportamentos não documentados — eles podem mudar sem aviso."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"contato-para-dúvidas","__idx":6},"children":["Contato para dúvidas"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para questões de conformidade, incidentes de segurança ou uso fora do padrão descrito:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uso responsável e conformidade: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:comercial@movvia.com.br"},"children":["comercial@movvia.com.br"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Proteção de dados e LGPD: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:privacidade@movvia.com.br"},"children":["privacidade@movvia.com.br"]}]}]}]},"headings":[{"value":"Uso Responsável da API","id":"uso-responsável-da-api","depth":1},{"value":"LGPD — proteção de dados","id":"lgpd--proteção-de-dados","depth":2},{"value":"Segurança de credenciais","id":"segurança-de-credenciais","depth":2},{"value":"Rate limits e consumo consciente","id":"rate-limits-e-consumo-consciente","depth":2},{"value":"Idempotência","id":"idempotência","depth":2},{"value":"Versionamento e sunsets","id":"versionamento-e-sunsets","depth":2},{"value":"Contato para dúvidas","id":"contato-para-dúvidas","depth":2}],"frontmatter":{"title":"Uso Responsável da API","description":"Diretrizes de uso responsável das APIs Movvia — LGPD, rate limits, segurança e boas práticas para integradores.","seo":{"title":"Uso Responsável da API"}},"lastModified":"2026-04-24T22:47:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/legal/uso-responsavel","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}