Angon Cloud
Angon CloudDocs
Prise en mainConfiguration

Démarrage rapide & Clés API

Récupérez vos clés d'accès et connectez votre jeu en moins de 3 minutes.

Pour connecter votre jeu à Angon Cloud, vous avez besoin de 3 informations essentielles délivrées par la console d'administration. Ce guide vous montre où les obtenir et comment les sécuriser.

Les 3 Identifiants Clés

IdentifiantDescriptionExemple
BaseURLL'URL racine de votre instance Angon Cloudhttps://votre-console.angon.cloud/api/public/v1
ApiKeyLa clé d'API publique associée à votre jeuak_live_7f8a9b2c4d5e...
GameIDL'identifiant unique UUID de votre jeu3c8f8697-3f30-4e31-8da3-6c84c6e91bf9

1. Récupérer Clé API et GameID

  1. Connectez-vous sur votre console d'administration Angon.
  2. Dans la barre latérale, ouvrez la section Jeux.
  3. Sélectionnez votre jeu ou cliquez sur Nouveau jeu pour en créer un.
  4. Dans la page du jeu, rendez-vous dans l'onglet Clés API / Accès.
  5. Cliquez sur le bouton Copier en face de votre clé API active.
Votre BaseURL en développement
Si vous testez en local avec le serveur de développement Vite, votre BaseURL est http://localhost:8080/api/public/v1. En production sur votre nom de domaine personnalisé, utilisez l'URL HTTPS publique de votre déploiement.

2. Niveaux de permissions des clés

Chaque clé d'API publique peut être configurée avec un niveau de sécurité précis dans la console :

Lecture seule

Le jeu peut uniquement lire les classements publics et le catalogue de la boutique. Idéal pour un site web vitrine ou un tableau d'affichage extérieur.

Joueur restreint (Défaut)

Le jeu peut lire et modifier uniquement les données du joueur connecté (ses scores, ses inventaires, ses fichiers). Recommandé pour tous les jeux en production.

Accès complet

Autorise les opérations d'administration sans restriction de joueur. Réservé au prototypage initial en environnement de test.

3. Bonnes pratiques de sécurité

  • Ne partagez jamais la clé secrète service_role : Seule la clé publique (commençant par ak_live_) doit être intégrée dans les jeux clients.
  • Régénérez votre clé en cas de fuite : Dans l'onglet Clés API, vous pouvez révoquer instantanément une clé compromise et en générer une nouvelle en un clic.
  • Activez le mode joueur restreint pour empêcher qu'un joueur malveillant ne falsifie les scores des autres utilisateurs.