Docs
EN

Objetivo

Servir un sitemap XML Sitemaps 0.9 con cada release y entrada pública del changelog para que los motores de búsqueda (Google, Bing, DuckDuckGo) puedan crawlear e indexarlos eficientemente. Útil cuando MexCep se white-labela en el sitio de docs de un cliente cuyo sitemap raíz debe incluir el changelog.

Prerrequisitos

Ninguno para obtener el sitemap. El envío a motores de búsqueda requiere propiedad del dominio de docs en el panel de webmaster del motor correspondiente.

Pasos

1. Obtener el sitemap

curl 'https://api.example.com/v1/public/changelog/sitemap.xml'

Respuesta (200):

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://docs.example.com/es/changelog</loc>
    <lastmod>2026-05-28</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.9</priority>
  </url>
  <url>
    <loc>https://docs.example.com/es/changelog/v1.49.6/url-convention</loc>
    <lastmod>2026-05-28</lastmod>
    <changefreq>monthly</changefreq>
    <priority>0.7</priority>
  </url>
  <!-- ... una <url> por cada release público ... -->
</urlset>

2. Enviar a Google Search Console

  1. Abre la página de envío de sitemaps de Search Console.
  2. Selecciona tu propiedad de docs verificada.
  3. En "Sitemaps", agrega la URL: https://api.example.com/v1/public/changelog/sitemap.xml.
  4. Click "Enviar". Google crawlea el sitemap en pocas horas.

3. Enviar a Bing Webmaster Tools

  1. Abre Bing Webmaster Tools.
  2. En "Sitemaps", agrega la misma URL.
  3. Click "Enviar".

4. (Opcional) Cambiar de idioma

curl 'https://api.example.com/v1/public/changelog/sitemap.xml?lang=es'

Las URLs <loc> cambian de locale (por ejemplo https://docs.example.com/es/changelog/...). Envía un sitemap por idioma si tus docs están publicadas en ambos.

Errores

EstadoCódigoCausa
400invalid_langlang fuera del enum.
429rate_limitedDemasiadas obtenciones del sitemap. Los motores nunca disparan esto; la causa habitual es un script de polling mal configurado.

Notas

  • El sitemap solo incluye entradas públicas. Las con embargo y las no publicadas se excluyen.
  • Los motores crawlean sitemaps a su propio ritmo (típicamente una vez al día para sitios activos). No hagas polling desde tu propia automatización — usa el feed Atom o el feed JSON en su lugar.
  • ADR-0090 (Convención de URL) explica el movimiento al namespace /v1/public/*.

Nuevo en v1.49.6 — ver ADR-0090.