Las mismas operaciones
Lo que hacéis en pantalla lo hacéis con una llamada: sitios, contenidos, imágenes, temas, menús, redirecciones, publicación, Search Console. La documentación enumera cada operación, una a una.
Desarrolladores
Joornal se gobierna por API
Todo lo que hace el back-office se hace también por API: crear un sitio, importar contenidos, publicar, leer los datos de Search Console. Con vuestras herramientas, en vuestros procesos, con los mismos permisos que vuestros usuarios.
Lo mismo que la interfaz, sin la interfaz
Esta API no es un subconjunto concedido a regañadientes. Es la misma aplicación, vista por el otro extremo.
Los mismos permisos
Un token solo alcanza el ámbito de quien lo posee: su cliente, sus proyectos, sus sitios. Un recurso fuera de él responde 403. No hay una «cuenta de API» aparte, con sus propias reglas que mantener al día.
Sin sesión, sin cookie
Una cabecera X-API-TOKEN por llamada, verificada cada vez. Nada que abrir, nada que renovar, nada que guardar en el navegador.
Errores que se parecen
Un contrato de error único en toda la API: un código estable legible por máquina, un mensaje legible por personas y el detalle campo a campo cuando falla una validación. Escribís el tratamiento de errores una sola vez.
Qué gobernáis
Los usos que más aparecen en agencias y grupos multimarca.
Alimentar desde vuestros sistemas
Importación masiva de contenidos, idempotente: repetir la misma llamada no crea duplicados, y decidís si deja en paz lo existente o lo actualiza. Podéis antedatar, programar una publicación, vincular categorías y firmantes, y subir las imágenes en el mismo movimiento.
Recuperar un sitio existente
Migración desde WordPress o desde una exportación, y luego la puesta en línea: tema, dominio, redirecciones, sitemap. El parque se crea y se configura por llamada, no por ticket.
Publicar en el momento justo
Lanzar una publicación, reprogramar una cola de artículos, seguir el avance. Las operaciones largas devuelven un identificador de tarea que consultáis hasta el final.
Recuperar los datos
Rendimiento de Search Console por artículo, estado de indexación URL a URL, estadísticas de paso de los robots, contactos recogidos por el formulario. Para alimentar vuestros cuadros de mando en lugar de copiarlos a mano.
Con qué podéis contar
Una API que se conecta es una API cuyas reglas se conocen de antemano. Las nuestras están escritas en la documentación, no en un contrato que hay que pedir.
Un año tras la obsolescencia
Un campo o una operación destinados a desaparecer se marcan primero en la especificación, con su sustituto y la fecha de la marca. Siguen sirviéndose al menos un año a partir de esa fecha. Siempre tenéis un año entero para moveros.
Una especificación que no miente
La especificación OpenAPI es pública, y nuestra integración continua rechaza cualquier cambio de la API que no venga acompañado de la actualización de su documentación. La documentación no puede quedarse atrás en silencio: muestra la fecha de su última revisión.
Límites anunciados
Cada respuesta lleva el margen que os queda. Nunca tenéis que descubrir un límite chocando con él, y podéis frenar antes de que os detenga.
Un filtro desconocido se rechaza
Un parámetro mal escrito o retirado produce un error, nunca un resultado que solo parece correcto. Es la clase de detalle que solo se nota el día en que ya os ha costado una semana.
Recupere el control de su visibilidad
Programe una demostración personalizada y descubra cómo construir un medio estructurado, eficaz y guiado por los datos.