Saltar al contenido principal

Obtener página por URL

En este ejemplo, demostramos cómo recuperar una única página de CMS por su identificador de URL utilizando la API de OneEntry.

✅ Propósito del escenario:

  • Conectar a la API de OneEntry
  • Recuperar una página por su identificador de URL
  • Acceder al contenido de la página a través de localizeInfos y attributeValues

✅ Lo que necesitas:

  • Un PROJECT_URL y APP_TOKEN válidos para la autenticación con la API de OneEntry.
  • Una página configurada en OneEntry con una URL conocida (por ejemplo, "home_web")

📌 Importante:

  • Estos ejemplos no incluyen manejo de errores.
  • Puedes gestionar errores utilizando un bloque try-catch o empleando una construcción como await Promise.catch((error) => error).

📚 Ver en la documentación:

📦 Referencia del SDK:

Pruébalo en vivo​

Ejecuta este método de forma interactiva en el sandbox del JS SDK — conecta tu Project URL y App Token en la primera visita, luego abre:

  • Obtener página por URL — En este ejemplo, demostramos cómo recuperar una única página de CMS por su identificador de URL utilizando la API de OneEntry.

Escenario​

1. Importar defineOneEntry desde el SDK y definir PROJECT_URL y APP_TOKEN​

Ejemplo:

import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

2. Crear un cliente API con defineOneEntry()​

Ejemplo:

const { Pages } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. Obtener página por URL con Pages.getPageByUrl()​

Ejemplo:

const page = await Pages.getPageByUrl('home_web');
console.log('Page: ', page);
Resultado:
{
  "id": 9,
  "parentId": null,
  "pageUrl": "home_web",
  "depth": 0,
  "localizeInfos": {
    "title": "Home web",
    "menuTitle": "Home web",
    "htmlContent": "",
    "plainContent": ""
  },
  "isVisible": true,
  "blocks": [],
  "type": "common_page",
  "templateIdentifier": null,
  "attributeSetIdentifier": null,
  "attributeValues": {},
  "moduleFormConfigs": [],
  "isSync": false
}

Ejemplo final​

// 1. Import defineOneEntry from SDK and define PROJECT_URL and APP_TOKEN
import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

// 2. Creating an API client with [defineOneEntry()](/docs/index/#Installation)
const { Pages } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. Get page by URL with [Pages.getPageByUrl()](/docs/pages/getPageByUrl)
const page = await Pages.getPageByUrl('home_web');
console.log('Page: ', page);