{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Versionamento","description":"Documentação oficial, guias e referência da API Auvo v2.","siteUrl":"https://developers.auvo.com.br","lang":"pt-BR","keywords":"auvo, api, documentação, developers, field service, workforce","meta":[{"name":"og:site_name","content":"Auvo Developers"},{"name":"og:locale","content":"pt_BR"},{"name":"og:locale:alternate","content":"es_ES"},{"name":"og:locale:alternate","content":"en_US"},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:site","content":"@auvoapp"}],"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":"versionamento","__idx":0},"children":["Versionamento"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A API Auvo adota ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["versionamento de URL"]},": a v2 vive em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2"]},". Mudanças"," ","compatíveis (adição de campos opcionais, novos endpoints) entram em v2;"," ","mudanças incompatíveis vão para a próxima major."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deprecation-policy","__idx":1},"children":["Deprecation policy"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Um endpoint ou campo marcado como deprecado permanece por ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["no mínimo 90 dias"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Deprecações aparecem:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-deprecation-date"]}," no spec."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Na resposta, via cabeçalho ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Deprecation: @timestamp"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/changelog"},"children":["changelog"]}," semanal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Em e-mail para administradores das contas que usaram o endpoint nos últimos 30 dias."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"o-que-não-é-breaking-change","__idx":2},"children":["O que NÃO é breaking change"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Novos campos opcionais em requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Novos campos em responses."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Novos endpoints / novos verbos."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Novos códigos 2xx e 4xx com significado adicional."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"o-que-é-breaking-change","__idx":3},"children":["O que É breaking change"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Remover/renomear campos ou endpoints."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mudar tipos/enums existentes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adicionar campos ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["obrigatórios"]}," em requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mudar códigos HTTP para operações já existentes."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"canal-de-comunicação","__idx":4},"children":["Canal de comunicação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Inscreva-se em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["changelog.rss"]}," ou siga nosso RSS/Atom feed. Assinantes de"," ","Webhooks com eventos ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api.deprecated"]}," também recebem notificação."]}]},"headings":[{"value":"Versionamento","id":"versionamento","depth":1},{"value":"Deprecation policy","id":"deprecation-policy","depth":2},{"value":"O que NÃO é breaking change","id":"o-que-não-é-breaking-change","depth":2},{"value":"O que É breaking change","id":"o-que-é-breaking-change","depth":2},{"value":"Canal de comunicação","id":"canal-de-comunicação","depth":2}],"frontmatter":{"title":"Versionamento","description":"Política de breaking changes, deprecations e comunicação.","seo":{"title":"Versionamento"}},"lastModified":"2026-04-24T13:01:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/versioning","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}