Portail Developpeur

Integre l'API NraxProject dans tes applications. Statistiques IRC, gestion de compte, et plus.

Authentication

Authentification par token

Toutes les requetes API non-publiques necessitent un token Bearer. Passe-le dans le header :

GET /api/v1/status
Authorization: Bearer nrx_sk_votre_cle_api_ici
Content-Type: application/json

Les cles API sont separees de votre mot de passe de connexion web. Vous pouvez en creer, revoquer et regenerer a tout moment.

Cles API

Gestion de vos cles

Creez et gerez vos cles API pour acceder aux endpoints :

Cle active
nrx_sk_a1b2c3d4e5f6...xxxx

Creee le 27/08/2026 · Derniere utilisation: il y a 2h · Revoquer

Gerer mes cles API

Endpoints

Statut du reseau

GET /api/v1/status Statut general du reseau
GET /api/v1/status/irc Statut du serveur IRC
GET /api/v1/status/voice Statut du serveur Voice

Public 100 req/min

Compte

POST /api/v1/account/register Creer un compte
GET /api/v1/account/me Infos du compte connecte
POST /api/v1/account/password Changer le mot de passe
DELETE /api/v1/account Supprimer le compte

Auth requise 30 req/min

Cles API

GET /api/v1/apikeys Lister les cles API
POST /api/v1/apikeys Creer une cle API
DELETE /api/v1/apikeys/:id Revoquer une cle

Auth requise 10 req/min

Statistiques IRC

GET /api/v1/irc/stats Utilisateurs connectes, channels
GET /api/v1/irc/channels Liste des channels
GET /api/v1/irc/users Utilisateurs en ligne (anonymises)

Auth requise 60 req/min

Rate Limits

100
requetes / minute
Endpoints publics
60
requetes / minute
Statistiques IRC
30
requetes / minute
Gestion de compte
10
requetes / minute
Cles API

Les headers X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset sont renvoyes dans chaque reponse.

Exemples

cURL - Statut du reseau

curl -s https://api.nraxproject.site/v1/status | jq .
{
  "status": "ok",
  "services": {
    "irc": { "online": true, "users": 42 },
    "voice": { "online": true, "users": 8 },
    "webchat": { "online": true }
  },
  "uptime": 864000
}

JavaScript - Recuperer les stats IRC

const response = await fetch('https://api.nraxproject.site/v1/irc/stats', {
  headers: {
    'Authorization': 'Bearer nrx_sk_votre_cle',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
console.log(data); // { users: 42, channels: 6, uptime: ... }

JavaScript - Creer un compte

const response = await fetch('https://api.nraxproject.site/v1/account/register', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    username: 'MonPseudo',
    email: 'email@example.com',
    password: 'MotDePasseSecurise123!'
  })
});

SDK et Librairies

Les SDK officiels seront bientot disponibles :

En attendant, utilisez fetch (JS) ou requests (Python) avec l'authentification Bearer.

Support developpeur

Pour toute question sur l'API :