Pannello Manager API: integrazione tecnica

Il Pannello Manager G Tech Group offre un'API REST completa per integrare la gestione DNS e dei domini nei tuoi sistemi automatici. Sviluppatori e amministratori di sistema possono automatizzare creazione record, monitoring, audit e bulk operations tramite chiamate HTTP autenticate.

Architettura dell'API

L'API segue principi REST: endpoint base https://api.manager.gtechgroup.it/v1/, autenticazione via Bearer token, formato JSON sia per richieste che risposte, rate limiting a 100 richieste/minuto per token, paginazione standard con cursor, errori conformi a HTTP status code (200, 201, 400, 401, 403, 404, 429, 500).

Generare un token API

Procedura:

1. Accedi al Pannello Manager con un'account amministratore.
2. Vai su "Impostazioni" > "API".
3. Clicca "Genera nuovo token".
4. Assegna un nome descrittivo (es. "CI/CD pipeline", "Backup script").
5. Seleziona i permessi: read-only o read-write, scope su domini specifici o tutti.
6. Imposta una scadenza (massimo 12 mesi).
7. Copia il token: viene mostrato una sola volta.
8. Conservalo in un password manager o secret store.

Endpoint principali

Riepilogo dei principali endpoint:

• GET /domains: lista domini gestiti.
• GET /domains/{id}: dettagli singolo dominio.
• POST /domains: aggiungi dominio.
• DELETE /domains/{id}: rimuovi dominio.
• GET /domains/{id}/records: lista record DNS.
• POST /domains/{id}/records: crea record DNS.
• PUT /domains/{id}/records/{rec_id}: modifica record.
• DELETE /domains/{id}/records/{rec_id}: elimina record.
• GET /domains/{id}/audit: log delle modifiche.
• POST /domains/{id}/export: esporta zona in formato BIND.

Esempio chiamata: creare un record A

Richiesta:

curl -X POST https://api.manager.gtechgroup.it/v1/domains/123/records \
-H "Authorization: Bearer TOKEN_QUI" \
-H "Content-Type: application/json" \
-d '{"type":"A","name":"www","value":"192.0.2.10","ttl":3600}'

Risposta (201 Created):

{"id":"rec_abc123","type":"A","name":"www","value":"192.0.2.10","ttl":3600,"created_at":"2026-06-29T10:30:00Z"}

Webhook e notifiche

L'API supporta webhook per notifiche real-time di eventi: cambio record DNS, scadenze domini, scadenze certificati, alert di sicurezza. Configura un'endpoint HTTPS del tuo sistema in "Impostazioni > Webhook". Il Pannello Manager invia un POST JSON con i dettagli evento, firmato HMAC-SHA256 per verifica autenticità.

Rate limiting e best practice

Limiti: 100 richieste/minuto per token, 1000/ora, 10000/giorno. Quando superi il limite, l'API risponde con HTTP 429 e header Retry-After. Best practice: implementa backoff esponenziale, batch le operazioni quando possibile, usa If-Match header per concurrency control, cache localmente le risposte se non cambiano frequentemente.

Errori comuni e come risolverli

• 401 Unauthorized: token scaduto o invalido. Rigenera o controlla il formato Bearer.
• 403 Forbidden: il token non ha i permessi necessari. Verifica scope assegnato.
• 429 Too Many Requests: rate limit superato. Aspetta il tempo indicato in Retry-After.
• 400 Validation Error: payload JSON malformato o campi obbligatori mancanti. Controlla la documentazione.
• 422 Unprocessable Entity: dato logicamente invalido (es. IPv6 in record A). Verifica i valori.

Domande frequenti

D: L'API è inclusa in tutti i piani?
R: Sì, l'accesso base è incluso. Rate limit superiori richiedono piani enterprise.

D: Posso usare l'API per gestire più clienti?
R: Sì, se hai un'account reseller con domini di terzi sotto la tua gestione.

D: Esistono librerie client ufficiali?
R: Sì, SDK per PHP, Python, Node.js, Go disponibili su github.com/gtechgroup.

D: L'API supporta versioning?
R: Sì, endpoint sotto /v1/ è la versione stabile. Future versioni saranno /v2/ con piano di deprecazione 12 mesi.

Hai bisogno di aiuto?

Se hai dubbi sul Pannello Manager G Tech Group, contattaci tramite il modulo di contatto.