Aller au contenu
ZAP Customer API

API REST pour développeurs

Connecte tes applications, bots et outils à tes services ZAP-Hosting. Gère serveurs de jeu, VPS, serveurs dédiés et TeamSpeak, ou intègre commandes et upgrades.

ClaudeCursorChatGPTGemini

L'accès API fait partie de ZapX Pass

Premiers pas

Démarre en 3 étapes

Crée une clé API et envoie ta première requête en quelques minutes.

  1. 1

    Créer une clé API

    Crée une clé sous Paramètres → Accès API et définis les autorisations nécessaires.

    Vers l'accès API
  2. 2

    Envoyer la première requête

    Transmets ta clé dans l'en-tête Authorization. /me t'indique si elle fonctionne et de quelles autorisations elle dispose.

  3. 3

    Utiliser la documentation

    La référence API interactive regroupe tous les endpoints, des exemples et la spécification OpenAPI.

    Référence API

Première requête (curl)

$ curl -s https://zap-hosting.com/api/v1/me \
  -H "Authorization: Bearer zapx_…" \
  -H "Accept: application/json"
200 OK· application/json
{
  "success": true,
  "data": {
    "userId": "usr_01HXYZ",
    "token": {
      "id": "cltok_01HXYZ",
      "name": "Automation",
      "accountPermissions": ["orders.view", "orders.create"],
      "serviceGrants": [
        {
          "serviceType": "gameserver",
          "serviceId": "clgs_01HXYZ",
          "permissions": ["gameserver.view", "gameserver.start"]
        }
      ],
      "typeGrants": []
    }
  }
}

Exemples d'utilisation

Développe ta propre intégration

Bot communautaire, tableau de bord maison ou processus de commande : l'API relie ton application à tes services ZAP-Hosting.

Intégrer la gestion des serveurs dans ton application

Affiche l'état, les sauvegardes et les configurations dans ta propre interface et exécute les actions serveur autorisées.

  • Afficher les services et leur état
  • Gérer sauvegardes et fichiers
  • Restreindre l'accès à certains services

Surveiller l'état et les logs console en temps réel

Utilise les données d'état actuelles et les logs console sous forme de Server-Sent Events pour ton monitoring et tes notifications.

  • Récupérer l'état actuel des services
  • Recevoir les logs console en flux continu
  • Déclencher des notifications lors d'événements importants

Intégrer commandes et upgrades

Commande de nouveaux services ou ajuste tes offres existantes directement depuis ton application.

  • Déclencher des commandes
  • Upgrades avec aperçu du prix
  • Consulter l'état des changements d'offre

Services pris en charge

Les bons endpoints pour tes services

La Customer API couvre serveurs de jeu, VPS, serveurs dédiés et TeamSpeak, ainsi que les commandes et les changements d'offre.

Serveur de jeu

Gère console, fichiers, sauvegardes, actions serveur et mods.

GET /api/v1/gameservers/{id}/console/logs

Serveur VPS

Pilote pare-feu, console, sauvegardes et administration du serveur.

GET /api/v1/vservers/{id}/firewall

Serveur dédié

Gère actions serveur, réinstallation, trafic, mode rescue et DDoS.

GET /api/v1/dedicated-servers/{id}

TeamSpeak

Automatise configuration, clients, bannissements et tokens.

GET /api/v1/teamspeak-servers/{id}

Commande & upgrade

Commande de nouveaux services et ajuste tes offres avec aperçu du prix.

POST /api/v1/orders

Accès et sécurité

Clés API et autorisations

Garde le contrôle sur les services et les actions que ton intégration peut utiliser.

Clés API (Bearer)

Envoie ta clé dans l'en-tête Authorization à chaque requête vers /api/v1/*. Tu peux créer ou remplacer tes clés à tout moment sous Paramètres → Accès API.

Autorisations par service

Définis à quels services et à quelles actions ton intégration peut accéder.

Opérations asynchrones

Pour les actions plus longues, tu reçois un ID d'opération et peux suivre leur progression via l'API.

API REST avec ZapX Pass Pluscrée ta clé API directement dans les paramètres avec un Pass Plus actif

Voir le ZapX Pass

Outils développeur

Tout pour ton intégration

Utilise la référence API, la spécification OpenAPI ou notre collection Postman pour bien démarrer.

Référence API interactive

Teste tous les endpoints avec des exemples directement dans ton navigateur.

OpenAPI

Spécification (OpenAPI 3.1) pour tes propres clients et générateurs de code.

API vs. MCP

API REST ou MCP ?

Choisis l'API REST pour tes propres applications et MCP pour travailler directement avec ton client IA.

Customer REST API

Pour tes propres applications, bots, tableaux de bord et automatisations.

  • Processus personnalisés et contrôle total des requêtes
  • Commandes et changements d'offre depuis ton application
  • Logs en temps réel et opérations asynchrones

MCP Connect

Pour Cursor, Claude et d'autres clients IA, via OAuth.

  • État, sauvegardes et pilotage des serveurs dans le chat
  • Autorisations définies pour chaque client IA
  • Pratique pour la gestion au quotidien

FAQ

Questions fréquentes sur l'API

L'essentiel sur tes propres intégrations ZapX.

Pour tes propres outils, apps et automatisations.

Connecte ZAP-Hosting à ton tableau de bord, à un bot ou à ta propre application. Tu peux consulter tes services, gérer tes serveurs, intégrer les sauvegardes et déclencher des commandes depuis ton application.

Serveurs de jeu, VPS, serveurs dédiés et TeamSpeak.

La Customer API met à disposition des fonctions pour tes serveurs de jeu, VPS, serveurs dédiés et serveurs TeamSpeak existants. Les domaines disponibles dépendent de ton compte et des droits d'accès de chaque service.

Avec une clé API personnelle.

Crée une clé API sous Paramètres → Accès API et envoie-la dans l'en-tête Authorization avec chaque requête. Tu trouveras des exemples adaptés dans la documentation API.

La bonne interface pour ton cas d'usage.

L'API REST est conçue pour tes propres applications, bots et automatisations. Avec MCP, tu connectes ZAP-Hosting directement à des clients IA comme Cursor ou Claude.

L'API est incluse dans le ZapX Pass Plus.

Oui. Pour utiliser la Customer REST API, il te faut un ZapX Pass Plus actif. Tu peux ensuite créer ta clé API sous Paramètres → Accès API.

Commandes et changements d'offre depuis ton application.

Oui. Tu peux commander de nouveaux services et ajuster tes offres existantes. Avant un changement d'offre, tu reçois un aperçu du prix.

D'autres questions ? Notre support te répond volontiers.

Contacter le support
Prêt ?

Connecte tes outils à ZapX

Ouvre la documentation API, crée une clé API et lance ta première requête.

L'accès API fait partie de ZapX Pass