Integraciones · API de contenido
Para el sitio hecho por un desarrollador, sin WordPress y sin Wix. El sitio busca los posts publicados en una API de lectura, con la clave del sitio, y arma las páginas a su manera, en la ruta que usted defina.
- Una clave del sitio, guardada en el servidor
- Lista, post completo y sitemap, por idioma
- El diseño y la dirección del blog siguen siendo de su sitio
Sin tarjeta · 4 posts en total, en 1 sitio
Paso a paso
Elija Sitio del desarrollador
En el portal, en Configuración, Conexión, elija Sitio del desarrollador y defina el prefijo del blog. Si no lo cambia, los posts quedan en /blog.
Genere la clave del sitio
En API keys del sitio, genere una clave. Empieza con bpa_ck_ y aparece completa una sola vez: cópiela en el momento.
Guárdela en el servidor
El desarrollador guarda la clave en una variable de entorno del servidor y la envía en el encabezado x-bpa-api-key en cada lectura. La prueba de conexión del sitio, en el portal, confirma la clave.
Arme las páginas una vez
Con la API, el desarrollador arma la lista de posts, la página del post y las entradas del sitemap. Después, cada post publicado aparece en el sitio por la propia API.
Qué entrega la API
GET /me
El sitio, el estado de la cuenta, los idiomas y la ruta del blog.
GET /posts?locale=es
Los posts publicados del idioma, del más nuevo al más antiguo: título, descripción, fecha, portada, etiquetas, autor y tiempo de lectura. Sin el HTML.
GET /posts/{locale}/{slug}
El post completo, con el HTML, las medidas de la portada y el slug de sus versiones en otros idiomas, cuando existen.
GET /sitemap
La ruta, la fecha del último cambio y el slug en cada idioma de cada post, para el sitemap.xml y el hreflang del sitio.
POST /validate confirma la clave. La API solo lee: el sitio no crea ni edita posts por ella.
Ejemplo
La dirección de la API aparece en el portal, junto a la clave.
# La clave queda en una variable de entorno del servidor
BPA_CONTENT_API_KEY=bpa_ck_…
# Los posts publicados en español
GET /posts?locale=es
x-bpa-api-key: bpa_ck_…
# Un post completo, con el HTML
GET /posts/es/{slug}
x-bpa-api-key: bpa_ck_…Límites
- La API solo lee. Crear, editar y aprobar posts sigue en el panel de BlogPost.
- Solo posts publicados: un borrador o un slug que no existe responden 404.
- Google lee el sitemap.xml de su sitio, no la API. Sume las entradas de /sitemap a las páginas del sitio.
- La clave no es el acceso al portal: cambiar la contraseña no tumba el blog. Revocar la clave en el portal corta la lectura en el momento, hasta que el sitio reciba una clave nueva.
- El post llega en HTML; el estilo es el de su sitio.
Otras integraciones
WordPress
Usuario y contraseña de aplicación, sin plugin: el paso a paso en WordPress.
Wix
ID del sitio, ID de miembro y clave de API: el paso a paso en Wix.
Todas las integraciones
WordPress, Wix y API lado a lado: qué pide cada una y qué llega.
Precios
4 posts gratis para probar; después, US$49/mes o US$490/año.
Sin tarjeta · 4 posts en total, en 1 sitio
API de contenidoRespuestas directas
Dudas del desarrollador.
Lo que más preguntan antes de conectar el sitio a la API de contenido.
¿Otra pregunta? Hable con el equipo IATEC por WhatsApp
No. El sitio lee los posts por la API de contenido y arma las páginas a su manera, sin WordPress y sin plugin.
La clave completa no queda guardada en el portal. Si todavía está en el servidor del sitio, péguela en el portal para probar de nuevo; si no, genere otra y revoque la anterior.
Por el sitemap.xml de su sitio. La ruta /sitemap devuelve la ruta y la fecha de cada post; el desarrollador suma esas entradas a las páginas del sitio.
Cada post tiene un idioma. La lista filtra por idioma, y el post trae el slug de sus versiones en otros idiomas, cuando existen, para el hreflang.