Vai al contenuto
ZAP Customer API

API REST per sviluppatori

Collega le tue applicazioni, i tuoi bot e i tuoi strumenti ai tuoi servizi ZAP-Hosting. Gestisci gameserver, VPS, server dedicati e TeamSpeak oppure integra ordini e upgrade.

ClaudeCursorChatGPTGemini

L'accesso API fa parte di ZapX Pass

Primi passi

Inizia in 3 passaggi

Crea una chiave API e invia la tua prima richiesta in pochi minuti.

  1. 1

    Crea una chiave API

    In Impostazioni → Accesso API crea una chiave e definisci i permessi necessari.

    Vai all'accesso API
  2. 2

    Invia la prima richiesta

    Trasmetti la tua chiave nell'header Authorization. /me ti mostra se funziona e quali permessi ha.

  3. 3

    Usa la documentazione

    Nel riferimento API interattivo trovi tutti gli endpoint, esempi e la specifica OpenAPI.

    Riferimento API

Prima richiesta (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": []
    }
  }
}

Esempi di utilizzo

Sviluppa la tua integrazione

Che si tratti di un bot per la community, di una dashboard personalizzata o di un processo d'ordine: l'API collega la tua applicazione ai tuoi servizi ZAP-Hosting.

Integra la gestione dei server nella tua applicazione

Mostra stato, backup e configurazioni nella tua interfaccia ed esegui le azioni server autorizzate.

  • Visualizzare i servizi e il loro stato
  • Gestire backup e file
  • Limitare l'accesso a singoli servizi

Monitora stato e log della console in tempo reale

Usa i dati di stato aggiornati e i log della console come Server-Sent Events per il tuo monitoraggio e le tue notifiche.

  • Recuperare lo stato attuale del servizio
  • Ricevere i log della console come flusso di dati
  • Attivare notifiche per gli eventi importanti

Integra ordini e upgrade

Ordina nuovi servizi o adatta i pacchetti esistenti direttamente nella tua applicazione.

  • Avviare ordini
  • Upgrade con anteprima del prezzo
  • Recuperare lo stato delle modifiche ai pacchetti

Servizi supportati

Gli endpoint giusti per i tuoi servizi

La Customer API copre gameserver, VPS, server dedicati, TeamSpeak, oltre a ordini e modifiche ai pacchetti.

Gameserver

Gestisci console, file, backup, azioni server e mod.

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

Server VPS

Controlla firewall, console, backup e gestione del server.

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

Server dedicati

Gestisci azioni server, reinstallazione, traffico, rescue e DDoS.

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

TeamSpeak

Automatizza configurazione, client, ban e token.

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

Ordini e upgrade

Ordina nuovi servizi e adatta i pacchetti con anteprima del prezzo.

POST /api/v1/orders

Accesso e sicurezza

Chiavi API e permessi

Mantieni il controllo su quali servizi e azioni può usare la tua integrazione.

Chiave API (Bearer)

Invia la tua chiave nell'header Authorization a ogni richiesta verso /api/v1/*. Puoi creare o sostituire le chiavi in qualsiasi momento in Impostazioni → Accesso API.

Permessi per servizio

Definisci a quali servizi e azioni può accedere la tua integrazione.

Operazioni asincrone

Per le azioni di lunga durata ricevi un ID operazione e puoi verificarne l'avanzamento tramite l'API.

API REST con ZapX Pass PlusCrea le chiavi API direttamente nelle impostazioni con un Pass Plus attivo

Scopri ZapX Pass

Strumenti per sviluppatori

Tutto per la tua integrazione

Usa il riferimento API, la specifica OpenAPI o la nostra Postman Collection per iniziare.

Riferimento API interattivo

Prova tutti gli endpoint con esempi direttamente nel browser.

OpenAPI

Specifica (OpenAPI 3.1) per client personalizzati e generatori di codice.

API vs. MCP

API REST o MCP?

Scegli l'API REST per le tue applicazioni e MCP per lavorare direttamente con il tuo client AI.

Customer REST API

Per applicazioni, bot, dashboard e automazioni personalizzate.

  • Flussi personalizzati e pieno controllo delle richieste
  • Ordini e modifiche ai pacchetti dalla tua applicazione
  • Log in tempo reale e operazioni asincrone

MCP Connect

Per Cursor, Claude e altri client AI con OAuth.

  • Stato, backup e controllo dei server in chat
  • Permessi definiti per ogni client AI
  • Pratico per la gestione quotidiana

FAQ

Domande frequenti sull'API

Tutto l'essenziale sulle tue integrazioni ZapX personalizzate.

Per strumenti, app e automazioni personalizzate.

Collega ZAP-Hosting alla tua dashboard, a un bot o a una tua applicazione. Puoi consultare i servizi, gestire i server, integrare i backup e avviare ordini dalla tua applicazione.

Gameserver, VPS, server dedicati e TeamSpeak.

La Customer API mette a disposizione funzioni per i tuoi gameserver, VPS, server dedicati e server TeamSpeak esistenti. Le aree disponibili dipendono dal tuo account e dai rispettivi permessi di accesso.

Con una chiave API personale.

Crea una chiave API in Impostazioni → Accesso API e inviala nell'header Authorization con ogni richiesta. Trovi esempi adatti nella documentazione API.

L'interfaccia giusta per il tuo caso d'uso.

L'API REST è pensata per applicazioni, bot e automazioni personalizzate. Con MCP colleghi ZAP-Hosting direttamente a client AI come Cursor o Claude.

L'API è inclusa in ZapX Pass Plus.

Sì. Per la Customer REST API ti serve uno ZapX Pass Plus attivo. Dopodiché puoi creare la tua chiave API in Impostazioni → Accesso API.

Ordini e modifiche ai pacchetti dalla tua applicazione.

Sì. Puoi ordinare nuovi servizi e adattare i pacchetti esistenti. Prima di una modifica al pacchetto ricevi un'anteprima del prezzo.

Hai ancora domande? Il nostro supporto ti aiuta volentieri.

Contatta il supporto
Pronto?

Collega i tuoi strumenti a ZapX

Apri la documentazione API, crea una chiave API e inizia con la tua prima richiesta.

L'accesso API fa parte di ZapX Pass