Une API REST JSON pour les statistiques, les avis, les évaluations et les téléphones

Les données derrière Astrina — analyses de site, avis, résumés de notes et intelligence téléphonique — sont désormais disponibles pour être intégrées directement dans votre propre code. L'API développeur est une API REST JSON qui vous restitue tout avec une seule clé.

Une clé, quatre points de terminaison

L'API est versionnée sous /api/v1 et chaque point de terminaison parle JSON simple. Orientez votre client vers la ressource dont vous avez besoin :

• GET /api/v1/stats — analyses pour un site que vous possédez : visiteurs, pages vues, pages principales, sources et pays.
• GET /api/v1/reviews — avis plus la note pour un sujet.
• GET /api/v1/rating — un résumé de note avec la distribution des étoiles.
• GET /api/v1/phone — intelligence téléphonique.

En plus de cela, l'API Auth alimente "Se connecter avec Astrina", afin que vous puissiez ajouter une connexion sociale à votre propre application sans construire vous-même une pile d'identité.

Authentifiez-vous de la manière qui convient le mieux à votre pile

Obtenez une clé de /my/api.php, puis envoyez-la de la manière la plus propre pour votre client. L'API accepte trois formes :

• Un X-Api-Key en-tête.
• Un Authorization: Bearer jeton.
• Un ?api_key=paramètre de requête.

L'authentification basée sur l'en-tête est la plus sûre par défaut pour le code côté serveur ; le paramètre de requête est pratique pour des tests rapides et des appels côté navigateur. Les réponses sont ouvertes CORS, vous pouvez donc appeler l'API directement depuis le front-end quand cela vous convient, et elles sont marquées noindex afin que vos données ne fuient pas dans les moteurs de recherche.

Quotas et plans

L'utilisation est mesurée par jour, et chaque réponse vous indique où vous en êtes — chaque charge utile inclut votre utilisation de quota, donc vous n'avez jamais à deviner combien d'appels il vous reste.

• Niveau gratuit : 100 appels par jour.
• Plan API : 10 000 appels par jour pour €19 tous les 30 jours.
• Niveau d'analytique commerciale :L'accès à l'API est inclus.

Commencez avec le plan gratuit pour prototyper, puis passez à un plan supérieur lorsque vos besoins d'intégration nécessitent plus de marge.

JSON prévisible, erreurs prévisibles

Le succès et l'échec reviennent tous deux sous forme de JSON. Lorsque quelque chose ne va pas, la réponse contient un error champ et le bon statut HTTP, de sorte que votre gestion des erreurs peut se baser sur le code de statut au lieu d'analyser des chaînes :

• 401 — clé incorrecte.
• 429 — quota dépassé.
• 400 / 422 — paramètres incorrects.

Comme l'état du quota est inclus dans chaque réponse, un client bien conçu peut se retirer avant de voir un 429.

Comment commencer

1. Ouvrir /my/api.php et créez une clé API.
2. Choisissez un point de terminaison — commencez par /api/v1/stats pour un site que vous possédez.
3. Envoyez votre clé dans l' X-Api-Key en-tête et lisez le JSON en retour.

Un premier appel est une ligne :

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

Vous préférez un jeton d'accès ? Échangez l'en-tête :

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

Ou insérez directement la clé dans l'URL pour un contrôle rapide :

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

À partir de là, le même modèle couvre les évaluations et l'intelligence téléphonique — une clé, un en-tête, quatre sources de données. Obtenez votre clé et passez votre premier appel aujourd'hui.