Campos de datos remotos

El tipo de campo Datos remotos permite que quienes editan trabajen con datos de una API HTTP externa. Contismo consulta la API al editar y resuelve el JSON en vivo al entregar (paso directo) o permite elegir opciones mapeadas que se guardan en la entrada (selección).

Úsalo cuando los valores deban venir de una fuente externa en vivo —catálogos de productos, registros de un CRM, listas de ubicaciones o cualquier API JSON— en lugar de escribirse a mano.

Agregar un campo de datos remotos

1. Abre Modelos de contenido o Taxonomías en el Studio.
2. Edita el modelo y agrega un campo.
3. Elige Datos remotos como tipo de campo.
4. Configura la solicitud y la respuesta (consulta más abajo).
5. Haz clic en Probar conexión para verificar que la API responde como esperas.
6. Guarda el modelo.

Configurar la solicitud

Cada campo de datos remotos necesita una configuración de solicitud:

• URL de datos remotos: la URL completa que devuelve los datos de este campo.
• Método HTTP: GET o POST.
• Parámetros de la solicitud (opcional): parámetros de la cadena de consulta que se agregan a la URL.
• Encabezados de la solicitud (opcional): encabezados personalizados que se envían con la solicitud. Marca un encabezado como Es privado para guardarlo como secreto cifrado.
• Autenticación básica (opcional): nombre de usuario y contraseña para las API que requieren autenticación básica HTTP.

Los valores privados se cifran

Los encabezados marcados como privados y las contraseñas de autenticación básica se cifran en reposo. Después de guardar el campo, el valor secreto completo no se vuelve a mostrar. Guarda una copia en un lugar seguro si necesitas reutilizarlo en otro lado.

Haz clic en Probar conexión mientras diseñas el esquema para confirmar que la API responde. Una prueba correcta muestra un resultado de ejemplo y, cuando aplica, las rutas de lista detectadas en la respuesta.

Modos de respuesta

Elige cómo se usa la respuesta de la API en el editor de entradas.

Paso directo

Paso directo resuelve el valor del campo desde la API remota cuando se entrega el contenido, por ejemplo al consultarlo a través de la API GraphQL.

• Ruta de la respuesta (opcional): ruta en notación de puntos para extraer una parte de la respuesta en lugar de devolver la carga completa. Por ejemplo, data.items o 0.title cuando la raíz es un arreglo.

En el editor de entradas, se puede abrir una vista previa de la respuesta actual de la API con Ver datos.

Seleccionar de la lista

Seleccionar de la lista mapea un arreglo de la respuesta de la API a opciones de una lista desplegable que se pueden elegir. El valor o los valores seleccionados se guardan en la entrada, en la base de datos.

Configura estas rutas (notación de puntos relativa a la raíz de la respuesta):

• Ubicación de la lista: ruta al arreglo de elementos (por ejemplo, items o data.results).
• Ruta del valor: propiedad de cada elemento que se guarda (por ejemplo, id).
• Ruta de la etiqueta: propiedad de cada elemento que se muestra (por ejemplo, name).
• Tipo de selección: Única o Múltiple.

En el editor de entradas, las opciones se obtienen de forma automática cuando la entrada está abierta. Quien edita elige uno o más valores de la lista mapeada.

Relacionado

Para una comparación rápida de todos los tipos de campo, consulta Tipos de campo.