Field Forge expone una API REST completa en /wp-json/fieldforge/v1/. Las lecturas del esquema del grupo de campos (GET /field-groups y GET /field-groups/{id}) son públicas, por lo que los frontends sin cabeza y desacoplados pueden inicializar esquemas de formulario/contenido sin cookies de WordPress. Los endpoints de lectura que contienen valores aún requieren usuarios autenticados con la capacidad de WordPress relevante, y los endpoints de escritura (POST/PUT/DELETE) requieren manage_options.
ETag y Cache-Control: private, max-age=60. Las respuestas GET autenticadas también incluyen ETags, pero WordPress puede añadir sus directivas estándar de no caché para usuarios conectados. Envía el ETag anterior de vuelta a través de If-None-Match para recibir un 304 Not Modified donde la caché del cliente es válida.
bash
# Application Passwords (WordPress 5.6+)
AUTH="admin:xxxx xxxx xxxx xxxx xxxx xxxx"
curl -s -u "$AUTH" \
-H "If-None-Match: \"$LAST_ETAG\"" \
"https://example.com/wp-json/fieldforge/v1/field-groups"Resumen de Endpoints de la API REST
| Método | Endpoint | Capacidad | Descripción |
|---|---|---|---|
GET | /fieldforge/v1/field-groups | Público | Listar grupos de campos públicos |
POST | /fieldforge/v1/field-groups | manage_options | Crear un grupo de campos |
GET | /fieldforge/v1/field-groups/{id} | Público | Obtener un único grupo de campos público |
PUT | /fieldforge/v1/field-groups/{id} | manage_options | Actualizar un grupo de campos |
DELETE | /fieldforge/v1/field-groups/{id} | manage_options | Eliminar un grupo de campos |
GET | /fieldforge/v1/fields/{post_id} | read_post (por publicación) | Obtener todos los valores para una publicación |
PUT | /fieldforge/v1/fields/{post_id} | manage_options | Actualizar valores para una publicación |
GET | /fieldforge/v1/options/{page} | edit_posts o read_private_posts | Obtener valores de la página de opciones |
POST | /fieldforge/v1/import/acf | manage_options | Importar desde ACF |
POST | /fieldforge/v1/generate | manage_options | Generación de esquemas AI (PRO, comienza en 2 créditos) |
Los endpoints GET de grupos de campos públicos filtran grupos marcados como private (o con reglas de ubicación limitadas a administradores) cuando el usuario solicitante no es un administrador.
—