App Android: come collegarla
L'app Android esistente funziona con questa API senza modifiche. Questa pagina riassume come si collega e cosa aspettarsi.
Come si collega
- Indirizzo di base dell'app:
https://seo.gtechgroup.it/api/(invariato rispetto al vecchio sito). L'app aggiunge a questo i percorsiseo/.... - Accesso: l'app invia
POST /api/logincon email e password e riceve{"data":{"api_key":"...","user":{...}}}. La chiave viene salvata e usata comeAuthorization: Bearer. - Le chiavi già emesse dal vecchio sito continuano a valere: non serve riaccedere.
- Il file dell'app è scaricabile da https://seo.gtechgroup.it/gtgseo-app-v21-0.14.4.apk.
curl -X POST https://seo.gtechgroup.it/api/login \
-H 'Content-Type: application/json' \
-d '{"email":"nome@esempio.it","password":"********"}'
Cosa funziona
Sono presenti tutti i percorsi che l'app chiama (ricavati dall'analisi dell'app):
| POST | /api/login |
| GET | /api/seo/status |
| GET | /api/seo/projects |
| GET | /api/seo/projects/{id} |
| POST | /api/seo/projects/{id}/keywords |
| POST | /api/seo/projects/{id}/refresh |
| GET | /api/seo/keywords/{id}/history |
| GET | /api/seo/spider |
| GET | /api/seo/spider/{id}/pages |
| GET | /api/seo/geo |
| GET | /api/seo/ai-visibility |
| GET | /api/seo/ai-engine |
| GET | /api/seo/ai-competitor |
| GET | /api/seo/prompt-research |
| POST | /api/seo/keyword-research |
| GET | /api/seo/alerts |
| PATCH | /api/seo/alerts/{id} |
| GET | /api/seo/search-console |
| GET | /api/seo/search-console/sites |
| GET | /api/seo/analytics |
| GET | /api/seo/analytics/properties |
| POST | /api/seo/device-tokens |
| DELETE | /api/seo/device-tokens/{token} |
Search Console e Analytics rispondono con i dati dell'account Google collegato; senza collegamento rispondono 409 e l'app mostra un messaggio.
Differenze da conoscere
- Il login restituisce una chiave nuova a ogni accesso (prima era una chiave fissa dell'utente). L'app la memorizza come prima, quindi non cambia nulla per chi la usa.
- Se l'account ha la 2FA attiva il login risponde 401 con
code: twofa_requiredfinché non viene inviato il codice (twofa_token). Se la versione dell'app non prevede il campo, serve usare una chiave API creata dall'account. - Le statistiche del progetto (
stats) hanno la forma completa:tracked,ranking,avg_position,buckets,gained,lost,timeline. - Le notifiche push richiedono la chiave del servizio di messaggistica sul server: finché non è configurata, la registrazione del dispositivo funziona ma non arrivano notifiche.
Verifica: la compatibilità è stata controllata sul codice dell'app e con test automatici, non ancora con l'app installata su un dispositivo reale.
