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

Autenticación
Genera una clave API
Ve al panel de control de tu proyecto en Sanity.io
Ve a la pestaña API
Haz clic en el botón "Add API Token"
Asigna un nombre a tu token (p. ej., "AirOps")
Configura los permisos como "Editor"
Haz clic en "Save"
Copia el token generado
Añade la clave API a AirOps
Ve a la página AirOps > Settings > Integrations
Haz clic en "Add New" y selecciona Sanity
Pega el token generado en el campo Clave API
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
ID del proyecto: El ID de tu proyecto de Sanity. (p. ej., "w22x3y4z")
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.
Tipo de recurso: El tipo de recurso que quieres listar. (p. ej., "post")
Último ID: Para usar la paginación, puedes establecer el último ID de la solicitud anterior. (Opcional)
¿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.
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.
JSON del recurso: El objeto JSON que representa el recurso que quieres crear.
Por ejemplo:
{ "title": "Mi nueva publicación", "category": "blog" }Cuando se usa junto con la entrada HTML del recurso, los atributos HTML se ignorarán de esta entrada.
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.
ID del recurso: El ID del recurso que quieres actualizar. (p. ej., "4ddb0459-2734-4611-b1af-4ee13f3d5630")
JSON del recurso: El objeto JSON que representa el recurso que quieres actualizar.
Por ejemplo:
{ "title": "Mi publicación actualizada", "category": "blog" }Cuando se usa junto con la entrada HTML del recurso, los atributos HTML se ignorarán de esta entrada.
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.
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.
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.
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 })Parámetros de consulta: Un objeto JSON de parámetros con nombre para pasar a la consulta. (Opcional)
Por ejemplo:
{ "status": "published" }puede usarse con una consulta como*[_type == "post" && status == $status]Ver https://www.sanity.io/docs/query-cheat-sheet para referencia de la sintaxis GROQ.
Última actualización
¿Te fue útil?