AntiVPN API projet

API publique projet

Consultez la configuration, les statistiques et les joueurs de votre projet, et effectuez des recherches par IP, pseudo ou UUID. Lecture seule.

Base http://novpn.zepioz.fr/api/v1/project JSON ← Dashboard

Authentification

Chaque requête doit porter la licence du projet, au choix :

GET http://novpn.zepioz.fr/api/v1/project/countries?license=VOTRE_CLE

GET http://novpn.zepioz.fr/api/v1/project/countries
x-api-key: VOTRE_CLE

Succès

{ "status": "success", "data": { … } }

Erreur

{ "status": "error", "message": "…" }

Avec la clé admin, précisez le projet ciblé via project_uuid ou project_license (ou les en-têtes x-project-uuid / x-project-license).

Endpoints

GET/lookup

Recherche unifiée. Le type de requête est détecté automatiquement et détermine la forme de la réponse (champ mode).

  • IP → classification de l’adresse et comptes l’ayant utilisée ;
  • CIDR / plage → comptes vus dans la plage ;
  • UUID → fiche complète (historique IP, comptes liés, derniers logs) ;
  • pseudo → liste des joueurs correspondants.

Paramètre requis : query

http://novpn.zepioz.fr/api/v1/project/lookup?license=VOTRE_CLE&query=8.8.8.8
http://novpn.zepioz.fr/api/v1/project/lookup?license=VOTRE_CLE&query=1.2.3.0/24
http://novpn.zepioz.fr/api/v1/project/lookup?license=VOTRE_CLE&query=Notch
http://novpn.zepioz.fr/api/v1/project/lookup?license=VOTRE_CLE&query=550e8400-e29b-41d4-a716-446655440000
GET/stats

Connexions totales, acceptées et refusées sur une période.

Optionnel : period = day | week | month | year | all (défaut week) 

http://novpn.zepioz.fr/api/v1/project/stats?license=VOTRE_CLE&period=month
GET/logs

Derniers logs de connexion, du plus récent au plus ancien.

Optionnel : limit (1–500, défaut 100)

http://novpn.zepioz.fr/api/v1/project/logs?license=VOTRE_CLE&limit=50
GET/users

Joueurs du projet, filtrables par statut de modération.

Optionnels : status = all | whitelist | blacklist | moderated | neutral, search, limit (1–1000), offset 

http://novpn.zepioz.fr/api/v1/project/users?license=VOTRE_CLE&status=whitelist
http://novpn.zepioz.fr/api/v1/project/users?license=VOTRE_CLE&status=blacklist&limit=100
GET/flags

Liste des flags IP reconnus par le service.

http://novpn.zepioz.fr/api/v1/project/flags?license=VOTRE_CLE
GET/blacklist/flags

Flags IP actuellement bloqués par le projet.

http://novpn.zepioz.fr/api/v1/project/blacklist/flags?license=VOTRE_CLE
GET/blacklist/countries

Codes pays actuellement bloqués par le projet.

http://novpn.zepioz.fr/api/v1/project/blacklist/countries?license=VOTRE_CLE
GET/countries

Catalogue de tous les pays présents dans la base réseau.

http://novpn.zepioz.fr/api/v1/project/countries?license=VOTRE_CLE

Vérification d’accès

L’endpoint appelé par votre serveur de jeu à chaque connexion. Il journalise la tentative et renvoie la décision.

GET/api/check

Requis : ip, uuid, key — optionnel : pseudo

GET /api/check?ip=1.2.3.4&uuid=UUID&pseudo=Notch&key=VOTRE_CLE

{
  "project": { "project_uuid": "…", "project_name": "…", "company_name": "…" },
  "ip": "1.2.3.4",
  "countryCode": "FR",
  "uuid": "…",
  "pseudo": "Notch",
  "is_authorized": false,
  "refusal_reasons": ["asn", "type"]
}

refusal_reasons détaille chaque règle déclenchée : user_blacklist, ip, asn, as_name, netblock, country, type.

Codes de réponse

CodeSignification
200Succès
400Paramètres invalides ou manquants
401Authentification manquante
403Clé refusée
404Projet ou ressource introuvable
500Erreur serveur