API

Les serveurs Premium peuvent générer une clé d'API en lecture seule depuis Paramètres → Accès API dans le panel, pour récupérer leurs données de recrutement depuis un outil externe (tableau de bord, script, intégration maison).

Toutes les requêtes se font sur https://api.recruitbot.app/public/v1/ avec l'en-tête :

Authorization: Bearer rb_votre_clé

Endpoints disponibles

• GET /public/v1/candidatures — liste les candidatures du serveur (paramètres optionnels status, limit)
• GET /public/v1/candidatures/:id — détail d'une candidature (réponses au formulaire incluses)
• GET /public/v1/stats — total et répartition par statut

La clé ne donne accès qu'aux données du serveur pour lequel elle a été générée, jamais en écriture. Elle peut être régénérée ou révoquée à tout moment depuis le panel — toute intégration utilisant l'ancienne clé cesse alors immédiatement de fonctionner. Limite : 60 requêtes/minute par clé.

L'API interne utilisée par le panel lui-même (/guilds/:guildId/...) reste privée, protégée par session, et n'est pas destinée à un usage externe.