API publique
L’API web de NodeWorld répond en JSON sur https://api.nodeworldvr.com. Cette documentation couvre sa partie publique, en lecture seule : ce que tout le monde peut lire sans compte, pour un site de communauté, un bot ou une page d’état.
bash
curl https://api.nodeworldvr.com/servers/regionsLes routes publiques
| Pour… | Route | Page |
|---|---|---|
| lister les serveurs et leurs mondes, comme les montre Explorer | GET /servers, GET /servers/regions | Liste des serveurs |
| lister les avatars publiés | GET /avatars/catalogue | Catalogue d’avatars |
| savoir si une version plus récente du jeu ou du serveur de jeu est sortie | GET /releases/latest | Vérification des mises à jour |
| savoir si l’API répond | GET /health, GET /health/ready | État de l’API |
Tout le reste demande le compte d’un joueur et sert au jeu et au site ; ce n’est pas documenté ici et peut changer à tout moment.
Réponses et erreurs
- Les réponses sont en JSON, en UTF-8. Les dates sont des chaînes ISO 8601 en UTC (
2026-10-27T09:30:00.000Z). - Une erreur a un statut HTTP (
400pour un paramètre faux,404pour ce qui n’existe pas) et un corps{ "error": "<message>" }. - Les adresses d’images dans les réponses sont signées et expirent au bout de quelques minutes : récupère-les vite, ne les garde pas.
L’appeler
- Ni clé, ni compte : envoie la requête.
- Les navigateurs ne laissent appeler l’API que depuis les sites de NodeWorld. Appelle-la depuis ton serveur, un bot ou un script, pas depuis le JavaScript d’un autre site.
- Demande au plus une fois par minute les listes qui changent lentement (serveurs, avatars) et garde la réponse entre-temps.