{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/es/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Versionado","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":"versionado","__idx":0},"children":["Versionado"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La API Auvo usa ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["versionado por URL"]},": v2 vive en ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2"]},". Los cambios"," ","compatibles (campos opcionales nuevos, nuevos endpoints) entran en v2; los"," ","cambios incompatibles pasan a la próxima versión mayor."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"política-de-deprecación","__idx":1},"children":["Política de deprecación"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un endpoint o campo marcado como deprecado permanece ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["al menos 90 días"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Las deprecaciones aparecen:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["En ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-deprecation-date"]}," del spec."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["En la respuesta, mediante el encabezado ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Deprecation: @timestamp"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["En el ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/changelog"},"children":["changelog"]}," semanal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Por correo a los administradores de cuentas que usaron el endpoint en los últimos 30 días."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-no-es-un-breaking-change","__idx":2},"children":["Qué NO es un breaking change"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Nuevos campos opcionales en requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Nuevos campos en responses."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Nuevos endpoints / nuevos verbos."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Nuevos códigos 2xx y 4xx con significado adicional."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sí-es-un-breaking-change","__idx":3},"children":["Qué SÍ es un breaking change"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Eliminar/renombrar campos o endpoints."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cambiar tipos/enums existentes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Agregar campos ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["obligatorios"]}," en requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cambiar códigos HTTP en operaciones ya existentes."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"canal-de-comunicación","__idx":4},"children":["Canal de comunicación"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Suscríbete a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["changelog.rss"]}," o sigue nuestro feed RSS/Atom. Quienes estén"," ","suscritos a Webhooks con el evento ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api.deprecated"]}," también reciben aviso."]}]},"headings":[{"value":"Versionado","id":"versionado","depth":1},{"value":"Política de deprecación","id":"política-de-deprecación","depth":2},{"value":"Qué NO es un breaking change","id":"qué-no-es-un-breaking-change","depth":2},{"value":"Qué SÍ es un breaking change","id":"qué-sí-es-un-breaking-change","depth":2},{"value":"Canal de comunicación","id":"canal-de-comunicación","depth":2}],"frontmatter":{"title":"Versionado","description":"Política de breaking changes, deprecaciones y comunicación.","seo":{"title":"Versionado"}},"lastModified":"2026-04-24T13:01:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/es/guides/versioning","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}