For the complete documentation index, see llms.txt. This page is also available as Markdown.

Sanity

La integración con Sanity te permite listar, crear, actualizar y consultar contenido en tu sitio de Sanity.io.

Sanity Integration step set to List Resources for the spaceops-site project, the production dataset, and the post resource type
Ejemplo de pasos que enumera los recursos de Sanity.

Autenticación

  1. Genera una clave API

    1. Ve al panel de control de tu proyecto en Sanity.io

    2. Ve a la pestaña API

    3. Haz clic en el botón "Add API Token"

    4. Asigna un nombre a tu token (p. ej., "AirOps")

    5. Configura los permisos como "Editor"

    6. Haz clic en "Save"

    7. Copia el token generado

  2. Añade la clave API a AirOps

    1. Ve a la página AirOps > Settings > Integrations

    2. Haz clic en "Add New" y selecciona Sanity

    3. Pega el token generado en el campo Clave API

    4. Haz clic en "Save"

Nota de seguridad: Trata tu clave API como una contraseña. Proporciona acceso a la API REST a tu instancia de Sanity y no debe compartirse. Guárdala de forma segura y úsala solo en entornos del lado del servidor o seguros/autenticados.

Funciones y sus parámetros

Parámetros de configuración comunes

  1. ID del proyecto: El ID de tu proyecto de Sanity. (p. ej., "w22x3y4z")

  2. Conjunto de datos: El conjunto de datos que quieres usar. (p. ej., "production")

Listar recursos

Obtiene una lista de recursos de tu proyecto de Sanity. Esto es útil para recuperar publicaciones, imágenes u otros tipos de contenido existentes. Devuelve 100 registros por página.

  1. Tipo de recurso: El tipo de recurso que quieres listar. (p. ej., "post")

  2. Último ID: Para usar la paginación, puedes establecer el último ID de la solicitud anterior. (Opcional)

  3. ¿Incluir borradores?: Si se deben incluir recursos en borrador en los resultados. (Opcional)

Obtener recurso

Obtiene un único recurso de tu proyecto de Sanity. Esto es útil para recuperar información detallada sobre una publicación o imagen específica.

La matriz de bloques se devolverá tal cual, pero se devolverá una estructura de datos complementaria con los atributos de los bloques convertidos a HTML simple dentro de __airops.html ruta JSON.

  1. ID del recurso: El ID del recurso que quieres obtener. (p. ej., "4ddb0459-2734-4611-b1af-4ee13f3d5630")

Crear recurso

Crea un nuevo recurso en tu proyecto de Sanity. Esto es útil para añadir nuevas publicaciones, imágenes u otros tipos de contenido.

  1. JSON del recurso: El objeto JSON que representa el recurso que quieres crear.

  2. HTML del recurso: Un objeto JSON que contiene como clave el nombre del atributo del recurso y como valor el documento HTML. (Opcional)

    • Por ejemplo: { "body": "<h1>Mi nueva publicación</h1><p>Este es el contenido de mi nueva publicación.</p>" }

    • Esto es útil para crear publicaciones con contenido de texto enriquecido.

    • El HTML se convertirá a la estructura Portable Text de Sanity y se usará en la carga útil para crear el recurso. Envía tantos atributos HTML como sean necesarios.

Actualizar recurso

Actualiza un recurso existente en tu proyecto de Sanity.

  1. ID del recurso: El ID del recurso que quieres actualizar. (p. ej., "4ddb0459-2734-4611-b1af-4ee13f3d5630")

  2. JSON del recurso: El objeto JSON que representa el recurso que quieres actualizar.

  3. HTML del recurso: Un objeto JSON que contiene como clave el nombre del atributo del recurso y como valor el documento HTML. (Opcional)

    • Por ejemplo: { "body": "<h1>Mi nueva publicación</h1><p>Este es el contenido de mi nueva publicación.</p>" }

    • Esto es útil para crear publicaciones con contenido de texto enriquecido.

    • El HTML se convertirá a la estructura Portable Text de Sanity y se usará en la carga útil para crear el recurso. Envía tantos atributos HTML como sean necesarios.

Subir imagen

Sube una imagen a tu proyecto de Sanity. Esto es útil para añadir imágenes a tu contenido o biblioteca multimedia.

  1. URL de la imagen: La URL de la imagen que quieres subir a Sanity. (p. ej., "https://example.com/image.jpg")

Publicar recurso

Publica un recurso en borrador en tu proyecto de Sanity, poniéndolo en línea y visible para tu audiencia.

  1. ID del recurso: El ID del recurso en borrador que quieres publicar. (p. ej., "drafts.4ddb0459-2734-4611-b1af-4ee13f3d5630")

Ejecutar consulta

Ejecuta una consulta arbitraria GROQ contra tu proyecto de Sanity. Esto es útil para obtener datos con filtrado, ordenación o proyecciones personalizadas que van más allá de la acción integrada List Resources.

  1. Consulta: La consulta GROQ que se ejecutará contra tu conjunto de datos. (p. ej., *[_type == "post" && status == "published"] | order(publishedAt desc) { _id, title, slug, publishedAt })

  2. Parámetros de consulta: Un objeto JSON de parámetros con nombre para pasar a la consulta. (Opcional)

Última actualización

¿Te fue útil?