REST API — Expón Campos Personalizados a Aplicaciones Headless | Field Forge - Campos personalizados, diseñados para la velocidad

Dos formas de acceder a campos personalizados

1. En línea en los endpoints REST principales

Cuando Field Forge está activo, cada wp/v2/posts, wp/v2/pages y wp/v2/{custom_post_type} incluye una propiedad fieldforge que contiene los valores de los campos personalizados:

“`json GET /wp-json/wp/v2/posts/123

{ “id”: 123, “title”: { “rendered”: “Sobre Nosotros” }, “content”: { “rendered”: “…” }, “fieldforge”: { “hero_title”: “Bienvenido a Nuestro Sitio”, “hero_subtitle”: “Construyendo mejores experiencias en WordPress”, “hero_image”: { “id”: 456, “url”: “https://example.com/hero.jpg”, “alt”: “Imagen principal”, “sizes”: { “thumbnail”: “https://…”, “medium”: “https://…”, “large”: “https://…” } }, “team_members”: [ { “name”: “Alice Johnson”, “photo”: { “id”: 234, “url”: “…”, “alt”: “Alice” }, “bio”: “Alice es…” }, { “name”: “Bob Smith”, “photo”: { “id”: 235, “url”: “…”, “alt”: “Bob” }, “bio”: “Bob es…” } ] } } “`

Así es como la mayoría de los sitios de WordPress headless consumen campos personalizados: obtienen una publicación, reciben los campos personalizados en la misma respuesta, sin necesidad de solicitudes adicionales.

2. Endpoints dedicados de Field Forge

Para casos de uso avanzados, Field Forge expone su propia API REST en /wp-json/fieldforge/v1/.

Referencia de endpoints

Grupos de campos

“ GET /wp-json/fieldforge/v1/field-groups GET /wp-json/fieldforge/v1/field-groups/{id} POST /wp-json/fieldforge/v1/field-groups PUT /wp-json/fieldforge/v1/field-groups/{id} DELETE /wp-json/fieldforge/v1/field-groups/{id} “

Lista, lee, crea, actualiza y elimina grupos de campos. Casos de uso: paneles de administración headless, configuración programática de grupos de campos, despliegue de esquemas CI/CD.

Valores de campos

“ GET /wp-json/fieldforge/v1/fields/{post_id} PUT /wp-json/fieldforge/v1/fields/{post_id} “

Obtén todos los valores de campos para una publicación específica, o actualízalos. La respuesta GET coincide con el formato devuelto en la propiedad fieldforge de la API REST principal.

Ejemplo: “ GET /wp-json/fieldforge/v1/fields/123 “

“json { "post_id": 123, "field_group": "hero-section", "values": { "hero_title": "Bienvenido", "hero_image": { "id": 456, "url": "..." } } } “

Páginas de opciones

“ GET /wp-json/fieldforge/v1/options/{page_slug} PUT /wp-json/fieldforge/v1/options/{page_slug} “

Lee y actualiza los valores de las páginas de opciones. Perfecto para sitios headless que necesitan configuraciones a nivel de sitio (nombre de la empresa, URLs sociales, CTAs globales).

Metadatos de esquema

“ GET /wp-json/fieldforge/v1/schema GET /wp-json/fieldforge/v1/schema/typescript GET /wp-json/fieldforge/v1/schema/graphql “

Obtén el esquema completo de Field Forge como JSON, o como definiciones de TypeScript, o como SDL de GraphQL. Úsalo en pipelines de construcción frontend para mantener los tipos sincronizados automáticamente.

Migración e importación

“ POST /wp-json/fieldforge/v1/import/acf POST /wp-json/fieldforge/v1/import/meta-box POST /wp-json/fieldforge/v1/import/cmb2 “

Activa importaciones desde plugins de origen a través de la API. Útil para scripts de configuración CI/CD.

Generación de IA

“ POST /wp-json/fieldforge/v1/generate “

Cuerpo: “json { "description": "Sección principal con título, subtítulo, imagen de fondo y botón CTA" } “

Devuelve un grupo de campos generado listo para guardar. Úsalo en herramientas de administración personalizadas o flujos de trabajo de automatización.

Autenticación

La API REST de Field Forge utiliza los mecanismos de autenticación nativos de WordPress:

Autenticación por cookies (usuarios conectados)

Si la solicitud proviene de un usuario de WordPress conectado (por ejemplo, tu panel de administración haciendo llamadas AJAX), las cookies del usuario autentican la solicitud automáticamente.

Contraseñas de aplicación (frontends headless)

WordPress 5.6+ soporta contraseñas de aplicación — credenciales de API por usuario que pueden generarse en el administrador de WordPress en Usuarios → Editar → Contraseñas de Aplicación. Úsalas para la autenticación en frontends headless:

“bash curl -u nombre_usuario:contraseña_aplicación https://wp.example.com/wp-json/fieldforge/v1/field-groups “

Autenticación JWT (plugin de terceros)

Si utilizas un plugin de autenticación JWT (como “JWT Authentication for WP REST API”), los endpoints de Field Forge aceptan tokens JWT automáticamente.

OAuth 2.0

Para uso empresarial, los endpoints de Field Forge son compatibles con plugins de servidor OAuth 2.0 de WordPress.

Comprobaciones de capacidad

Los endpoints REST respetan las capacidades de WordPress:

Operaciones de lectura (GET): requieren la capacidad read (típicamente cualquier usuario conectado)
Operaciones de escritura (POST, PUT, DELETE) en campos: requieren la capacidad edit_post en la publicación objetivo
CRUD de grupos de campos: requieren la capacidad manage_options (solo administradores)
Importación/migración: requieren la capacidad manage_options

Puedes filtrar esto con hooks de capacidades estándar de WordPress si necesitas diferentes modelos de permisos.

Valores de campo Pro en la API REST de WP

Field Forge expone los valores de campo en los endpoints REST principales de WordPress como una propiedad fieldforge. Este es el enfoque recomendado para frontends headless porque:

Una solicitud obtiene datos de la publicación + campos personalizados (sin problema N+1)
Formato estándar de API REST — sin curva de aprendizaje
Funciona con clientes de API REST de WordPress (bibliotecas de clientes wp-rest-api en JS, PHP, Python, etc.)
Compatible con generadores de sitios estáticos (Next.js getStaticProps, Astro getStaticPaths, etc.)

Para la mayoría de los sitios headless, la propiedad fieldforge en los endpoints REST principales es todo lo que necesitas. Los endpoints dedicados de Field Forge son para casos de uso avanzados.

Rendimiento en la API REST

Las respuestas de la API REST se benefician del almacenamiento de tablas personalizadas y carga por lotes de Field Forge. Una única consulta REST que obtiene una publicación + campos personalizados se ejecuta en 1–2 consultas SQL en lugar de 20+.

Para endpoints de lista (/wp/v2/posts?per_page=20), el auto-preloader de Field Forge agrupa las consultas de campos personalizados de las 20 publicaciones en una sola consulta, manteniendo los tiempos de respuesta rápidos incluso para vistas de lista con mucho contenido.

Combinando con GraphQL

Field Forge soporta tanto la API REST como la integración de WPGraphQL. Usa la que mejor se adapte a tu frontend:

API REST — más simple, funciona con cualquier cliente HTTP
GraphQL — más eficiente para consultas profundamente anidadas, mejor seguridad de tipos cuando se combina con GraphQL Code Generator

Ambas APIs exponen los mismos datos subyacentes de Field Forge.

¿Listo para ir headless con campos personalizados de WordPress?

Obtén Field Forge — desde $35/año →

La API REST está incluida en todos los planes de pago. Los valores de campo en los endpoints REST principales también están en la versión gratuita.