Eine REST JSON API für Statistiken, Bewertungen, Rezensionen & Telefon

Die Daten hinter Astrina — Website-Analysen, Bewertungen, Zusammenfassungen von Bewertungen und Telefonintelligenz — sind jetzt verfügbar, um direkt in Ihren eigenen Code integriert zu werden. Die Developer API ist eine REST JSON API, die alles über einen einzigen Schlüssel zurückgibt.

Ein Schlüssel, vier Endpunkte

Die API ist versioniert unter /api/v1 und jeder Endpunkt spricht einfaches JSON. Richten Sie Ihren Client auf die Ressource, die Sie benötigen:

• GET /api/v1/stats — Analysen für eine von Ihnen besessene Website: Besucher, Seitenaufrufe, Top-Seiten, Quellen und Länder.
• GET /api/v1/reviews — Bewertungen plus die Bewertung für ein Thema.
• GET /api/v1/rating — eine Zusammenfassung der Bewertung mit der Verteilung der Sterne.
• GET /api/v1/phone — Telefonintelligenz.

Zusätzlich dazu ermöglicht die Auth API "Login mit Astrina", damit Sie die soziale Anmeldung in Ihre eigene App integrieren können, ohne selbst einen Identitätsstapel zu erstellen.

Authentifizieren Sie sich, wie es zu Ihrem Stack passt

Holen Sie sich einen Schlüssel von /my/api.php, und senden Sie ihn auf die sauberste Weise für Ihren Client. Die API akzeptiert drei Formen:

• Ein X-Api-Key Header.
• Ein Authorization: Bearer Token.
• Ein ?api_key=Abfrageparameter.

Header-basierte Authentifizierung ist die sicherste Standardoption für serverseitigen Code; der Abfrageparameter ist praktisch für schnelle Tests und browserseitige Aufrufe. Die Antworten sind CORS-offen, sodass Sie die API direkt vom Frontend aus aufrufen können, wenn es Ihnen passt, und sie sind gekennzeichnet noindexdamit Ihre Daten nicht in Suchmaschinen gelangen.

Kontingente und Pläne

Die Nutzung wird pro Tag gemessen, und jede Antwort sagt Ihnen, wo Sie stehen – jede Nutzlast enthält Ihre Kontingentnutzung, sodass Sie nie raten müssen, wie viele Aufrufe Sie noch haben.

• Kostenloses Kontingent: 100 Aufrufe pro Tag.
• API-Plan: 10.000 Aufrufe pro Tag für €19 alle 30 Tage.
• Business-Analytics-Stufe:API-Zugriff ist enthalten.

Beginnen Sie kostenlos mit dem Prototyping und steigen Sie dann auf, wenn Ihre Integration mehr Spielraum benötigt.

Vorhersehbares JSON, vorhersehbare Fehler

Erfolg und Misserfolg kommen beide als JSON zurück. Wenn etwas schiefgeht, enthält die Antwort ein errorFeld und den richtigen HTTP-Status, sodass Ihre Fehlerbehandlung auf dem Statuscode basieren kann, anstatt Strings zu parsen:

• 401 — ungültiger Schlüssel.
• 429 — Kontingent überschritten.
• 400 / 422 — ungültige Parameter.

Da der Kontingentstatus in jeder Antwort enthalten ist, kann ein gut funktionierender Client zurücktreten, bevor er jemals einen 429 sieht.

Wie man anfängt

1. Öffnen Sie /my/api.php und erstelle einen API-Schlüssel.
2. Wähle einen Endpunkt — beginne mit /api/v1/stats für eine Website, die dir gehört.
3. Sende deinen Schlüssel im X-Api-Key Header und lese das JSON zurück.

Ein erster Aufruf ist eine Einzeiler:

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

Bevorzugst du ein Bearer-Token? Tausche den Header aus:

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

Oder füge den Schlüssel direkt in die URL für eine schnelle Überprüfung ein:

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

Von dort aus deckt dasselbe Muster Bewertungen und Telefonintelligenz ab – ein Schlüssel, ein Header, vier Datenquellen. Holen Sie sich Ihren Schlüssel und tätigen Sie noch heute Ihren ersten Anruf.