Saltearse al contenido

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'
}
nombredescripción
idEl 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.
contentTypeEl modelo del contenido que queremos recuperar.
Por ejemplo: client.getRawContent({ id: '1', contentType: 'post' })
languageEl 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[];
};
nombredescripción
stringFiltra 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
inFiltra 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.