Lorsque Field Forge est actif, chaque réponse wp/v2/posts, wp/v2/pages, et wp/v2/{custom_post_type} inclut une propriété fieldforge contenant les valeurs des champs personnalisés :
“`json GET /wp-json/wp/v2/posts/123
{ “id”: 123, “title”: { “rendered”: “À Propos de Nous” }, “content”: { “rendered”: “…” }, “fieldforge”: { “hero_title”: “Bienvenue sur Notre Site”, “hero_subtitle”: “Construire de meilleures expériences WordPress”, “hero_image”: { “id”: 456, “url”: “https://example.com/hero.jpg”, “alt”: “Image héroïque”, “sizes”: { “thumbnail”: “https://…”, “medium”: “https://…”, “large”: “https://…” } }, “team_members”: [ { “name”: “Alice Johnson”, “photo”: { “id”: 234, “url”: “…”, “alt”: “Alice” }, “bio”: “Alice est…” }, { “name”: “Bob Smith”, “photo”: { “id”: 235, “url”: “…”, “alt”: “Bob” }, “bio”: “Bob est…” } ] } } “`
C’est ainsi que la plupart des sites WordPress headless consomment des champs personnalisés — récupérer un article, obtenir des champs personnalisés dans la même réponse, aucune demande supplémentaire nécessaire.
Pour des cas d’utilisation avancés, Field Forge expose sa propre API REST sous /wp-json/fieldforge/v1/.
“ 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} “
Lister, lire, créer, mettre à jour et supprimer des groupes de champs. Cas d’utilisation : panneaux d’administration headless, configuration programmatique de groupes de champs, déploiement de schémas CI/CD.
“ GET /wp-json/fieldforge/v1/fields/{post_id} PUT /wp-json/fieldforge/v1/fields/{post_id} “
Obtenez toutes les valeurs des champs pour un article spécifique, ou mettez-les à jour. La réponse GET correspond au format renvoyé dans la propriété fieldforge de l’API REST principale.
Exemple : “ GET /wp-json/fieldforge/v1/fields/123 “
“json { "post_id": 123, "field_group": "hero-section", "values": { "hero_title": "Bienvenue", "hero_image": { "id": 456, "url": "..." } } } “
“ GET /wp-json/fieldforge/v1/options/{page_slug} PUT /wp-json/fieldforge/v1/options/{page_slug} “
Lire et mettre à jour les valeurs des pages d’options. Parfait pour les sites headless qui ont besoin de paramètres globaux (nom de l’entreprise, URL sociales, CTA globaux).
“ GET /wp-json/fieldforge/v1/schema GET /wp-json/fieldforge/v1/schema/typescript GET /wp-json/fieldforge/v1/schema/graphql “
Récupérez le schéma complet de Field Forge au format JSON, ou en tant que définitions TypeScript, ou en tant que SDL GraphQL. Utilisez-le dans les pipelines de construction frontend pour maintenir les types synchronisés automatiquement.
“ POST /wp-json/fieldforge/v1/import/acf POST /wp-json/fieldforge/v1/import/meta-box POST /wp-json/fieldforge/v1/import/cmb2 “
Déclenchez des importations depuis des plugins sources via l’API. Utile pour les scripts de configuration CI/CD.
“ POST /wp-json/fieldforge/v1/generate “
Corps : “json { "description": "Section héroïque avec titre, sous-titre, image de fond et bouton CTA" } “
Renvoie un groupe de champs généré prêt à être enregistré. Utilisez-le dans des outils d’administration personnalisés ou des workflows d’automatisation.
L’API REST de Field Forge utilise les mécanismes d’authentification natifs de WordPress :
Si la demande provient d’un utilisateur WordPress connecté (par exemple, votre panneau d’administration effectuant des appels AJAX), les cookies de l’utilisateur authentifient automatiquement la demande.
WordPress 5.6+ prend en charge les mots de passe d’application — des identifiants API par utilisateur qui peuvent être générés dans l’administration WordPress sous Utilisateurs → Modifier → Mots de passe d’application. Utilisez-les pour l’authentification des frontends headless :
“bash curl -u username:application_password https://wp.example.com/wp-json/fieldforge/v1/field-groups “
Si vous utilisez un plugin d’authentification JWT (comme “JWT Authentication for WP REST API”), les points de terminaison de Field Forge acceptent automatiquement les jetons JWT.
Pour un usage en entreprise, les points de terminaison de Field Forge sont compatibles avec les plugins de serveur OAuth 2.0 de WordPress.
Les points de terminaison REST respectent les capacités de WordPress :
read (généralement tout utilisateur connecté)edit_post sur l’article ciblemanage_options (administrateurs uniquement)manage_optionsVous pouvez filtrer ces capacités avec des hooks de capacité standard de WordPress si vous avez besoin de modèles de permission différents.
Field Forge expose les valeurs des champs sur les points de terminaison REST principaux de WordPress en tant que propriété fieldforge. C’est l’approche recommandée pour les frontends headless car :
getStaticProps, Astro getStaticPaths, etc.)Pour la plupart des sites headless, la propriété fieldforge sur les points de terminaison REST principaux est tout ce dont vous avez besoin. Les points de terminaison dédiés de Field Forge sont pour des cas d’utilisation avancés.
Les réponses de l’API REST bénéficient du stockage de table personnalisé et du chargement par lots de Field Forge. Une seule requête REST récupérant un article + des champs personnalisés s’exécute en 1 à 2 requêtes SQL au lieu de 20+.
Pour les points de terminaison de liste (/wp/v2/posts?per_page=20), le préchargeur automatique de Field Forge regroupe les requêtes de champs personnalisés sur les 20 articles en une seule requête, maintenant des temps de réponse rapides même pour des vues de liste riches en contenu.
Field Forge prend en charge à la fois l’API REST et l’intégration WPGraphQL. Utilisez celui qui convient le mieux à votre frontend :
Les deux API exposent les mêmes données sous-jacentes de Field Forge.
Obtenez Field Forge — à partir de 35$/an →
L’API REST est incluse dans chaque plan payant. Les valeurs des champs sur les points de terminaison REST principaux sont également disponibles dans la version gratuite.