wordpress/wp-rest-api

¿Qué hace wp-rest-api?

Úselo al crear, extender o depurar endpoints/rutas de la API REST de WordPress: register_rest_route, clases WP_REST_Controller/controller, validación de esquemas/argumentos, permission_callback/autenticación, modelado de respuestas, register_rest_field/register_meta, o exponer CPTs/taxonomías mediante show_in_rest.

¿Qué es?

Esta habilidad ayuda a los asistentes de IA a trabajar con la API REST de WordPress, proporcionando orientación sobre las mejores prácticas para definir rutas, validar datos, gestionar permisos y dar forma a las respuestas de la API.

Funcionalidades clave

• Registro de rutas: Usar register_rest_route para definir endpoints personalizados.
• Controladores: Extender WP_REST_Controller para una estructura de código reutilizable.
• Validación de esquemas: Definir esquemas de argumentos con tipos, valores predeterminados y callbacks de validación/sanitización.
• Callbacks de permisos: Implementar permission_callback para control de acceso.
• Modelado de respuestas: Devolver objetos WP_REST_Response con códigos de estado y datos correctos.
• Campos y metadatos personalizados: Usar register_rest_field y register_meta para exponer campos adicionales.
• CPTs y taxonomías: Habilitar show_in_rest para exponer tipos de contenido personalizados y taxonomías.

Plataformas compatibles

• Claude Code
• Cursor
• Codex
• Cualquier editor o terminal compatible con asistentes de IA.

Cómo usarlo

Simplemente incluya esta habilidad en la configuración de su asistente de IA (archivo .cursorrules en Cursor, archivo CLAUDE.md en Claude Code, o mediante código en Codex).

Ejemplo

// Registrar un endpoint personalizado
add_action('rest_api_init', function () {
    register_rest_route('mi-plugin/v1', '/items/(?P<id>\d+)', array(
        'methods' => 'GET',
        'callback' => 'mi_plugin_get_item',
        'permission_callback' => function () {
            return current_user_can('edit_posts');
        },
        'args' => array(
            'id' => array(
                'validate_callback' => function($param, $request, $key) {
                    return is_numeric($param);
                }
            )
        )
    ));
});

Notas importantes

• Siempre use callbacks de validación y sanitización para evitar vulnerabilidades de seguridad.
• Los controladores extendidos de WP_REST_Controller facilitan el mantenimiento y la reutilización del código.
• Para exponer metadatos, use register_meta con show_in_rest establecido en true.
• Consulte la documentación oficial de la API REST de WordPress para obtener más detalles.