Una API REST JSON para estadísticas, reseñas, calificaciones y teléfono

Los datos detrás de Astrina — análisis del sitio, reseñas, resúmenes de calificaciones e inteligencia telefónica — ahora están disponibles para integrarse directamente en tu propio código. La API para desarrolladores es una API REST JSON que devuelve todo a través de una sola clave.

Una clave, cuatro puntos finales

La API está versionada bajo /api/v1 y cada punto final habla JSON simple. Apunta tu cliente al recurso que necesitas:

• GET /api/v1/stats — análisis para un sitio que posees: visitantes, vistas de página, páginas principales, fuentes y países.
• GET /api/v1/reviews — reseñas más la calificación para un tema.
• GET /api/v1/rating — un resumen de calificaciones con la distribución de estrellas.
• GET /api/v1/phone — inteligencia telefónica.

Además de esto, la API de Auth potencia "Iniciar sesión con Astrina", para que puedas agregar inicio de sesión social a tu propia aplicación sin construir un sistema de identidad tú mismo.

Autentica de la manera que se ajuste a tu sistema

Obtén una clave de /my/api.php, luego envíala de la manera más limpia para tu cliente. La API acepta tres formas:

• Un X-Api-Key encabezado.
• Un Authorization: Bearer token.
• Un ?api_key= parámetro de consulta.

La autenticación basada en encabezados es la opción más segura por defecto para el código del lado del servidor; el parámetro de consulta es útil para pruebas rápidas y llamadas del lado del navegador. Las respuestas son abiertas a CORS, por lo que puedes llamar a la API directamente desde el front end cuando te convenga, y están marcadas noindex para que tus datos no se filtren en los motores de búsqueda.

Cuotas y planes

El uso se mide por día, y cada respuesta te dice en qué posición estás: cada carga incluye el uso de tu cuota, por lo que nunca tienes que adivinar cuántas llamadas te quedan.

• Nivel gratuito: 100 llamadas por día.
• Plan de API: 10,000 llamadas por día por €19 cada 30 días.
• Nivel de análisis empresarial:El acceso a la API está incluido.

Comienza con Free para prototipar, luego avanza cuando tu integración necesite más capacidad.

JSON predecible, errores predecibles

El éxito y el fracaso regresan como JSON. Cuando algo sale mal, la respuesta lleva un error campo y el estado HTTP correcto, para que tu manejo de errores pueda ramificarse según el código de estado en lugar de analizar cadenas:

• 401 — clave incorrecta.
• 429 — cuota excedida.
• 400 / 422 — parámetros incorrectos.

Dado que el estado de la cuota se envía en cada respuesta, un cliente bien comportado puede retroceder antes de que vea un 429.

Cómo empezar

1. Abre /my/api.php y crea una clave de API.
2. Elige un endpoint — comienza con /api/v1/stats para un sitio que posees.
3. Envía tu clave en el X-Api-Key encabezado y lee el JSON de vuelta.

Una primera llamada es una línea:

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

¿Prefieres un token de portador? Cambia el encabezado:

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

O coloca la clave directamente en la URL para una verificación rápida:

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

Desde allí, el mismo patrón cubre las calificaciones y la inteligencia telefónica: una clave, un encabezado, cuatro fuentes de datos. Obtén tu clave y haz tu primera llamada hoy.