Un'API REST JSON per statistiche, recensioni, valutazioni e telefono

I dati dietro Astrina — analisi del sito, recensioni, riepiloghi delle valutazioni e intelligenza telefonica — sono ora disponibili per essere integrati direttamente nel tuo codice. L'API per sviluppatori è un'API REST JSON che restituisce tutto da una singola chiave.

Una chiave, quattro endpoint

L'API è versionata sotto /api/v1 e ogni endpoint parla JSON semplice. Punta il tuo client alla risorsa di cui hai bisogno:

• GET /api/v1/stats — analisi per un sito che possiedi: visitatori, visualizzazioni di pagina, pagine principali, fonti e paesi.
• GET /api/v1/reviews — recensioni più la valutazione per un argomento.
• GET /api/v1/rating — un riepilogo delle valutazioni con la distribuzione delle stelle.
• GET /api/v1/phone — intelligenza telefonica.

In aggiunta a questi, l'API di autenticazione alimenta "Accedi con Astrina", così puoi aggiungere il login sociale alla tua app senza dover costruire un sistema di identità da solo.

Autenticati nel modo che si adatta al tuo stack

Prendi una chiave da /my/api.php, poi inviala nel modo più pulito per il tuo client. L'API accetta tre forme:

• Un X-Api-Key intestazione.
• Un Authorization: Bearer token.
• Un ?api_key= parametro di query.

L'autenticazione basata su header è il metodo predefinito più sicuro per il codice lato server; il parametro di query è utile per test rapidi e chiamate lato browser. Le risposte sono aperte a CORS, quindi puoi chiamare l'API direttamente dal front end quando ti conviene, e sono contrassegnate noindex in modo che i tuoi dati non vengano indicizzati nei motori di ricerca.

Quote e piani

L'uso è misurato per giorno, e ogni risposta ti dice a che punto sei — ogni payload include l'uso della tua quota, quindi non devi mai indovinare quante chiamate ti rimangono.

• Livello gratuito: 100 chiamate al giorno.
• Piano API: 10.000 chiamate al giorno per €19 ogni 30 giorni.
• Livello di analisi aziendale:L'accesso all'API è incluso.

Inizia con il piano gratuito per il prototipo, poi passa a un piano superiore quando le tue esigenze di integrazione richiedono più spazio.

JSON prevedibile, errori prevedibili

Il successo e il fallimento tornano entrambi come JSON. Quando qualcosa va storto, la risposta contiene un error campo e il giusto stato HTTP, in modo che la tua gestione degli errori possa diramarsi in base al codice di stato invece di analizzare le stringhe:

• 401 — chiave non valida.
• 429 — quota superata.
• 400 / 422 — parametri non validi.

Poiché lo stato della quota è incluso in ogni risposta, un client ben comportato può ritirarsi prima di vedere mai un 429.

Come iniziare

1. Apri /my/api.php e crea una chiave API.
2. Scegli un endpoint — inizia con /api/v1/stats per un sito che possiedi.
3. Invia la tua chiave nell' X-Api-Key intestazione e leggi il JSON di ritorno.

Una prima chiamata è una riga:

curl -H "X-Api-Key: YOUR_KEY" https://astrina.io/api/v1/stats

Preferisci un token bearer? Scambia l'intestazione:

curl -H "Authorization: Bearer YOUR_KEY" https://astrina.io/api/v1/reviews

Oppure inserisci direttamente la chiave nell'URL per un controllo veloce:

curl "https://astrina.io/api/v1/rating?api_key=YOUR_KEY"

Da lì, lo stesso schema copre le valutazioni e l'intelligenza telefonica — una chiave, un'intestazione, quattro fonti di dati. Prendi la tua chiave e fai la tua prima chiamata oggi.