De ce nu funcționează endpoint-ul meu personalizat pentru API?

Iată problema ta:

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

Mai exact ideea că acest lucru este posibil:

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

Acest lucru este extrem de neobișnuit și contravine documentației, ghidurilor și tutorialelor.

Endpoint-urile REST API trăiesc în cadrul REST API, care se află la URL-ul returnat de rest_url(). Ele se află la yoursite.com/wp-json. Un endpoint nu este un URL complet sau un API independent deconectat de API-ul principal.

În schimb, trebuie să-ți definești numele endpoint-urilor în termeni de namespace-uri și endpoint-uri și să vizitezi URL-ul corect așa cum este descris în mecanismele de descoperire ale REST API.

Dacă folosim acest lucru:

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

Atunci ne-am aștepta la acest lucru:

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

Acest URL este destul de lung și are o serie de probleme:

• Primul parametru este un namespace, nu un URL
• nu este posibil să separi corect versiunea v1 a API-ului de v2 datorită modului în care componenta /form a fost pusă în primul parametru, nu în al doilea. Primul parametru este un namespace, al doilea este o rută
• /action este /action, nu este înlocuit cu GET sau POST

Există și probleme cu funcția de callback:

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

Un endpoint trebuie să returneze datele, nu le poate afișa direct așa cum ar face var_dump, altfel datele returnate nu sunt un JSON valid.

În cele din urmă, parametrul methods este incorect:

'methods' => 'GET, POST',

methods nu acceptă o listă separată prin virgulă, nici documentația nu sugerează acest lucru. În schimb, folosește valorile predefinite oferite de REST API, cum ar fi WP_REST_Server::READABLE sau WP_REST_Server::ALLMETHODS, acestea sunt menționate în ghid și în documentația oficială pentru register_rest_route.

O rută mai bună de înregistrat ar fi:

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

Dându-ne:

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

Observă cum am eliminat URL-ul pluginului și fragmentul redundant /api (este deja evident că este un API)

În cazul meu, trebuie doar să adaug wp-json în URL-ul expeditorului webhook, ceea ce va rezulta în

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

iar în fișierul meu functions.php aceste linii de cod funcționează

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) {
  // Procesează cererea webhook
  $data = $request->get_body(); // Obține corpul cererii
  // Efectuează acțiuni bazate pe datele primite prin webhook

  // Returnează un răspuns dacă este necesar
  return new WP_REST_Response('Webhook primit.', 200);
}