Ir al contenido

Hygraph y Astro

Hygraph es una plataforma federada de gestión de contenido. Expone un endpoint de GraphQL para obtener contenido.

En esta sección, crearás un endpoint de GraphQL de Hygraph para obtener contenido con Astro.

Para comenzar, necesitarás tener lo siguiente:

  1. Una cuenta y proyecto de Hygraph. Si no tienes una cuenta, puedes registrarte gratis y crear un proyecto nuevo.

  2. Permisos de acceso de Hygraph - en Project Settings > API Access, configura los permisos de Public Content API para permitir solicitudes de lectura sin autenticación. Si no has configurado ningún permiso, puedes hacer clic en Yes, initialize defaults para añadir los permisos requeridos para usar la “High Performance Content API”.

Para añadir tu endpoint de Hygraph a Astro, crea un archivo .env en la raíz de tu proyecto con la siguiente variable:

.env
HYGRAPH_ENDPOINT=YOUR_HIGH_PERFORMANCE_API

Ahora deberías poder utilizar esta variable de entorno en tu proyecto.

Si quieres tener IntelliSense para tus variables de entorno, puedes crear un archivo env.d.ts en tu directorio src/ y configurar ImportMetaEnv de la siguiente manera:

src/env.d.ts
interface ImportMetaEnv {
readonly HYGRAPH_ENDPOINT: string;
}

Tu directorio raíz deberá incluir ahora los siguientes archivos:

  • Directoriosrc/
    • env.d.ts
  • .env
  • astro.config.mjs
  • package.json

Obtén datos de tu proyecto de Hygraph utilizando HYGRAPH_ENDPOINT.

Por ejemplo, para obtener entradas de un tipo de contenido blogPosts que contenga un campo de tipo string title, crea una consulta de GraphQL para obtener ese contenido. Después, define el tipo del contenido y establécelo como el tipo de la respuesta.

src/pages/index.astro
---
interface Post {
title: string;
}
const query = {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
query: `
{
blogPosts {
title
}
}`,
}),
};
const response = await fetch(import.meta.env.HYGRAPH_ENDPOINT, query);
const json = await response.json();
const posts: Post[] = json.data.blogPosts;
---
<html lang="en">
<head>
<meta charset="utf-8" />
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<meta name="viewport" content="width=device-width" />
<meta name="generator" content={Astro.generator} />
<title>Astro</title>
</head>
<body>
<h1>Astro</h1>
{
posts.map((post) => (
<div>
<h2>{post.title}</h2>
</div>
))
}
</body>
</html>

Para configurar un webhook en Netlify:

  1. Despliega tu sitio en Netlify con esta guía. Recuerda agregar tu HYGRAPH_ENDPOINT a las variables de entorno.

  2. A continuación, ve al panel de tu proyecto de Hygraph y haz clic en Apps.

  3. Ve al marketplace, busca Netlify y sigue las instrucciones proporcionadas.

  4. Si todo ha salido bien, ahora podrás desplegar tu sitio web con un solo clic desde la interfaz de Hygraph.

Más guías de CMS

Socios de CMS destacados

  • CloudCannon

    Git-based CMS built for speed, security, and zero headaches.

Todas las guías de CMS

Contribuir Comunidad Patrocinador