Points d'accès personnalisés

Lie un script à sa propre route HTTP sous /api/v1/scripts/*.

Configuration :

• Méthode HTTP (au choix).
• Motif de chemin – segments fixes, paramètres nommés (:id) et un joker final (*) sont autorisés, par exemple /commandes/:id/status. Si plusieurs motifs enregistrés se recoupent pour une requête, le plus spécifique l’emporte (fixe avant paramètre nommé avant joker).
• Mode d’authentification : public (accessible sans connexion) ou connecté (session ou jeton API requis).

L'objet request

Le script dispose d’un objet global request :

request.method   // "GET", "POST", ...
request.path     // le chemin appelé
request.params   // paramètres de chemin nommés, p. ex. { id: "42" }
request.query    // paramètres de la chaîne de requête
request.headers  // en-têtes HTTP
request.body     // JSON analysé, sinon le texte brut

La réponse

Soit via l’objet response (chaînable) :

response.status(201).json({ ok: true });
// ou : response.send("texte brut");
// ou : response.setHeader("X-Custom", "valeur");

Soit simplement la dernière expression/valeur return du script – elle est alors automatiquement renvoyée en JSON, sans aucun appel à response.*.