getRawContent

La función getRawContent obtiene un solo contenido sin procesar (valores de contenido y metadatos) de un proyecto. Esta función es útil para obtener un contenido específico, como un artículo o una entrada de blog.

Ejemplo:

// Usando el cliente que ya hemos creado previamente
const content = await client.getRawContent({ id: '1' });
console.log(content);

Interfaz

La función getRawContent acepta como parámetros un objeto QueryParams requerido y devuelve una promesa que se resuelve con el contenido.

export interface ApiClient {
  getRawContent: <Model>(queryParam: QueryParams<Model>) => Promise<Content>;
  // ... otros métodos
}

Parámetros

queryParam: Un objeto que contiene los parámetros de consulta para filtrar el contenido. Este parámetro es opcional y si no se proporciona, se devolverá el contenido completo.

interface QueryParams {
  id?: Filter;
  contentType?: Filter;
  language?: Filter;
  'fields.${string}'?: Filter; // Permite filtrar por valores específicos de campos
  // Por ejemplo: 'fields.slug': 'my-post'
}

nombre	descripción
`id`	El campo `id` del contenido a recuperar. Este parámetro debe ser un `string` Ejemplo: `client.getContent({ id: '1' })` Puedes encontrar el `id` del contenido en la pestaña Contenido de tu proyecto.
`contentType`	El modelo del contenido que queremos recuperar. Por ejemplo: `client.getRawContent({ id: '1', contentType: 'post' })`
`language`	El idioma del contenido que queremos recuperar. Cuando aplicamos este filtro, solamente devolverá los campos del modelo en el idioma seleccionado y descartará los demás. Por ejemplo: `client.getRawContent({ id: '1', language: 'es' })`
`fields.${string}`	Permite filtrar por valores específicos de campos. Ejemplos: `client.getContent({ 'fields.slug': 'my-post' } })` `client.getContent({ 'fields.title': { in: ['Hello World', 'Hola Mundo'] } })` Recupera contenido con campos que coincidan con los valores especificados.

type Filter =
  | string
  | {
      in?: string[];
    };

nombre	descripción
`string`	Filtra el contentido donde el parámetro `es igual` a este valor. Por ejemplo: `client.getRawContent('1', { contentType: 'post' })` Recupera un contentido cuyo `modelo es igual a post`
`in`	Filtra el contenido donde el parámetro `contiene alguno` de estos valores. Por ejemplo: `client.getRawContent('1', { language: { in: ['es', 'en'] } })` Recupera un contenido filtrando los campos que coincidan con `es` y/o `en`

Salida

La función getRawContent devuelve un objeto que contiene el contenido sin procesar (filtrado o no). Este objeto representa los valores del contenido y meta-datos:

export interface Content {
  id: string;
  contentType: { id: string; name: string };
  lastUpdate: Date;
  fields: Field[];
}

export interface Field {
  id: string;
  name: string;
  value: any;
  type: FieldType;
  isArray: boolean;
  language: string;
}

Como puedes ver, cada contenido tiene un id, un contentType (que representa el modelo al que pertenece), una fecha de última actualización lastUpdate y un array de fields que representan los campos del contenido.

Consumir los campos tal cual como se definen en esta interfaz es útil si se quiere integrar con un sistema externo, por ejemplo integrarlo con un servidor de GraphQL o si se quiere hacer un mapeo de los campos a otro tipo de contenido.

Sin embargo, la forma más sencilla y recomendable de consumir los contenidos es a través de la función mapContentToModel una vez que ya hemos recuperado los datos, devuelve el contenido ya mapeado a su modelo correspondiente. O directamente usar el método getContent que ya hace este mapeo automáticamente.

Ejemplo:

import { createClient, mapContentToModel } from '@content-island/api-client';

// ... código de inicialización del cliente

// Tu modelo Post definido en Content Island
interface Post {
  id: string; // Id del contenido
  title: string; // Campo definido en el modelo
  body: string; // Campo definido en el modelo
  order: number; // Campo definido en el modelo
  language: 'es' | 'en'; // o cualquier otro idioma que tengas definido en tu proyecto
}

const content = await client.getRawContent('1');
console.log(content);
/*
  {
    id: '1',
    contentType: { id: '100', name: 'post' },
    lastUpdate: '2023-10-01T12:00:00Z',
    fields: [
      { id: '111', name: 'title', value: 'Hola Mundo', type: 'short-text', isArray: false, language: 'es' },
      { id: '222', name: 'body', value: 'Este es el cuerpo del post en markdown.', type: 'long-text', isArray: false, language: 'es' },
      { id: '333', name: 'order', value: 1, type: 'number', isArray: false, language: 'es' },
    ],
  }
*/

const post = mapContentToModel<Post>(content);
console.log(post);

/*
  {
    id: '1',
    title: 'Hola Mundo',
    body: 'Este es el cuerpo del post en markdown.',
    order: 1,
    language: 'es',
  }
*/

Puedes ver que el contenido ya está mapeado a su modelo correspondiente y puedes acceder a los campos directamente sin tener que hacer un mapeo manual. Para más información sobre esta función, puedes consultar la sección de mapContentToModel.