Perché il mio endpoint API personalizzato non funziona?

Ecco il tuo problema:

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

Nello specifico, l'idea che questo sia possibile:

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

Questo è estremamente insolito e va contro quanto riportato nella documentazione, manuali e tutorial.

Gli endpoint dell'API REST risiedono nell'API REST, che si trova all'URL restituito da rest_url(). Risiedono in tuosito.com/wp-json. Un endpoint non è un percorso URL completo, né un'API indipendente disconnessa dall'API principale.

Invece, devi definire i nomi dei tuoi endpoint in termini di namespace ed endpoint, e visitare l'URL corretto come descritto nei meccanismi di scoperta dell'API REST.

Se usiamo questo:

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

Allora ci aspetteremmo questo:

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

Questo URL è piuttosto lungo e presenta diversi problemi:

• Il primo parametro è un namespace, non un URL
• non è possibile separare correttamente la versione v1 dell'API dalla v2 a causa del modo in cui il componente /form è stato inserito nel primo parametro, non nel secondo. Il primo parametro è un namespace, il secondo una route
• /action è /action, non viene sostituito con GET o POST

Ci sono anche problemi con la funzione di callback:

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

Un endpoint deve restituire i suoi dati, non può emetterli direttamente come farebbe var_dump, altrimenti i dati restituiti non saranno JSON validi.

Infine, il parametro dei metodi è incorretto:

'methods' => 'GET, POST',

methods non accetta un elenco separato da virgole, nessuna documentazione suggerisce di fare ciò. Invece, usa i valori predefiniti forniti dall'API REST come WP_REST_Server::READABLE o WP_REST_Server::ALLMETHODS, tutti menzionati nel manuale e nella documentazione ufficiale di register_rest_route.

Una route migliore da registrare sarebbe:

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

Che ci dà:

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

Nota come ho rimosso l'URL del plugin e il frammento ridondante /api (è già ovvio che si tratta di un'API)

Nel mio caso, basta aggiungere wp-json all'URL del mittente del webhook, che risulterà in

https://my-domain.local/wp-json/my-plugin/v1/action

e nel mio functions.php queste righe di codice funzionano

add_action('rest_api_init', 'register_webhook_endpoint');

function register_webhook_endpoint() {
  register_rest_route('my-plugin/v1', '/action', array(
    'methods' => 'POST',
    'callback' => 'handle_webhook_request',
  ));
}

function handle_webhook_request(WP_REST_Request $request) {
  // Elabora la richiesta del webhook
  $data = $request->get_body(); // Ottieni il corpo della richiesta
  // Esegui azioni in base ai dati del webhook ricevuti

  // Restituisci una risposta se necessario
  return new WP_REST_Response('Webhook ricevuto.', 200);
}