DocumentationPremiers pas

Démarrage rapide

De zéro à un premier appel API authentifié.

1. Créer un compte

curl -X POST https://hoosthubs-g.onrender.com/api/users/register \
  -H "Content-Type: application/json" \
  -d '{"username":"mon_pseudo","password":"motdepasse"}'

Le nom d'utilisateur accepte lettres, chiffres, _ et . (3 à 50 caractères). Mot de passe : 6 à 100 caractères. L'e-mail est optionnel.

2. Obtenir un jeton

curl -X POST https://hoosthubs-g.onrender.com/api/token \
  -d "username=mon_pseudo&password=motdepasse"

La réponse contient access_token. Le même jeton est aussi posé dans un cookie access_token pour la navigation web.

3. Appeler l'API

curl https://hoosthubs-g.onrender.com/api/users/me -H "Authorization: Bearer VOTRE_TOKEN"

4. Publier

curl -X POST https://hoosthubs-g.onrender.com/api/actfile \
  -H "Authorization: Bearer VOTRE_TOKEN" -H "Content-Type: application/json" \
  -d '{"content":"Bonjour IDDET !","category":"Autres"}'

Et ensuite ?