¿Por qué no funciona mi endpoint API personalizado?

Aquí está tu problema:

register_rest_route( plugin_dir_url(__DIR__).'my-project/api/v1/form', '/action', array(

Específicamente, la idea de que esto sea posible:

http://my-domain.local/wp-content/plugins/my-project/api/v1/form

Esto es extremadamente inusual y va en contra de lo que dicen los documentos, el manual y los tutoriales.

Los endpoints de la API REST viven en la API REST, que reside en la URL devuelta por rest_url(). Viven en tusitio.com/wp-json. Un endpoint no es una ruta URL completa, ni una API independiente desconectada de la API principal.

En su lugar, debes definir tus nombres de endpoints en términos de espacios de nombres y endpoints, y visitar la URL correcta como se describe en los mecanismos de descubrimiento de la API REST.

Si usamos esto:

register_rest_route( plugin_dir_url(__DIR__).'my-project/api/v1/form', '/action', array(

Entonces esperaríamos esto:

example.com/wp-json/wp-content/plugins/my-project/api/v1/form/action

Esa URL es bastante larga y tiene varios problemas:

• El primer parámetro es un espacio de nombres, no una URL
• No es posible separar correctamente la versión v1 de la API de la v2 debido a que el componente /form se ha colocado en el primer parámetro, no en el segundo. El primer parámetro es un espacio de nombres, el segundo una ruta.
• /action es /action, no se intercambia por GET o POST

También hay problemas con la función de callback:

function api_method($data) {
    var_dump($data);

Un endpoint necesita devolver sus datos, no puede mostrarlos directamente como lo haría var_dump, de lo contrario los datos devueltos no son JSON válido.

Finalmente, el parámetro de métodos es incorrecto:

'methods' => 'GET, POST',

methods no toma una lista separada por comas, ningún documento sugiere hacer esto tampoco. En su lugar, usa los valores predefinidos proporcionados por la API REST como WP_REST_Server::READABLE o WP_REST_Server::ALLMETHODS, todos mencionados en el manual y la documentación oficial de register_rest_route.

Una mejor ruta para registrar sería:

    register_rest_route( 'my-project/form/v1', '/action', array(

Dándonos:

example.com/wp-json/my-project/form/v1/action

Observa cómo eliminé la URL del plugin y el fragmento redundante /api (ya es obvio que es una API).

En mi caso, simplemente añado wp-json en la URL del webhook emisor, lo que resultará en

https://mi-dominio.local/wp-json/mi-plugin/v1/accion

y en mi archivo functions.php estas líneas de código funcionan

add_action('rest_api_init', 'registrar_endpoint_webhook');

function registrar_endpoint_webhook() {
  register_rest_route('mi-plugin/v1', '/accion', array(
    'methods' => 'POST',
    'callback' => 'manejar_solicitud_webhook',
  ));
}

function manejar_solicitud_webhook(WP_REST_Request $request) {
  // Procesar la solicitud del webhook
  $data = $request->get_body(); // Obtener el cuerpo de la solicitud
  // Realizar acciones basadas en los datos del webhook recibido

  // Devolver una respuesta si es necesario
  return new WP_REST_Response('Webhook recibido.', 200);
}