Construisez avec l'API astrologique AstroWay

Démarrage rapide

Obtenez votre horoscope quotidien sans clé API :

curl "https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"

Inscrivez-vous pour obtenir une clé gratuite

Obtenez une clé gratuite - 10 000 crédits/mois, sans carte

Première requête avec votre clé

curl -G "https://api.astroway.info/v1/chart" \
  -H "X-Api-Key: aw_live_…" \
  --data-urlencode "datetime=1990-06-15T14:30:00+03:00" \
  --data-urlencode "lat=50.45" --data-urlencode "lon=30.52"

Consultez tarifs pour les limites de tarifs et le coût des crédits par endpoint.

Authentification

Trois tarifs. Choisissez le vôtre.

Liaison au domaine

Les clés payantes sont liées à un seul domaine lors de la première requête. Il est possible de le modifier soi-même dans l'espace client, jusqu'à 3 fois par mois. L'installation du plugin WordPress envoie automatiquement l'en-tête X-AstroWay-Site-URL sans modifier le code.

Gestion des erreurs

• 401 — clé API X-Api-Key absente ou invalide
• 402 — l'abonnement ne comprend pas cet endpoint (ex. : endpoint HD sans Pack HD)
• 403 — inadéquation de domaine (domaine lié ≠ en-tête Origin)
• 429 — limite de requêtes dépassée ou crédits mensuels épuisés (en-tête Retry-After défini)

Widgets intégrés

iframe direct - fonctionne sur tout site HTML, sans chargeur JS. Tarif anonyme, 30 requêtes/heure par IP de visiteur.

Horoscope quotidien

<iframe src="https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
        width="100%" height="320" loading="lazy" frameborder="0"></iframe>

Roue de la carte natale

<iframe src="https://api.astroway.info/v1/embed/natal-wheel?datetime=1990-06-15T14:30:00%2B03:00&lat=50.45&lon=30.52"
        width="600" height="600" loading="lazy" frameborder="0"></iframe>

Carte du jour Tarot

<iframe src="https://api.astroway.info/v1/embed/tarot-daily?deck=rider-waite"
        width="400" height="500" loading="lazy" frameborder="0"></iframe>

Phase Lunaire

<iframe src="https://api.astroway.info/v1/embed/moon-phase"
        width="320" height="320" loading="lazy" frameborder="0"></iframe>

Installation sur WordPress

Installez plugin AstroWay pour WordPress ↗ - widgets Tier 1 sans configuration, shortcodes à copier, clé API optionnelle pour Tier 2/3.

SDK officiels

Trois SDK natifs. Typage fort complet, générés à partir d'OpenAPI 3.1. Licence MIT. Avec réessais et opérations idempotentes.

npm install @astroway/sdk

import { AstroWayClient } from '@astroway/sdk';
const c = new AstroWayClient({ apiKey: process.env.ASTROWAY_KEY });
const chart = await c.natalChart({
  datetime: '1990-06-15T14:30:00+03:00',
  lat: 50.45, lon: 30.52
});

pip install astroway

from astroway import AstroWayClient
c = AstroWayClient(api_key="aw_live_…")
chart = c.natal_chart(
    datetime="1990-06-15T14:30:00+03:00",
    lat=50.45, lon=30.52,
)

composer require astroway/sdk

use AstroWay\AstroWayClient;
$c = new AstroWayClient(apiKey: 'aw_live_…');
$chart = $c->natalChart(
    datetime: '1990-06-15T14:30:00+03:00',
    lat: 50.45, lon: 30.52,
);

WordPress

Site WordPress ? Le plugin gratuit AstroWay для WordPress ↗ ajoute des thèmes natals, des horoscopes, le Tarot, la numérologie et le Human Design via des shortcodes et des blocs Gutenberg - sans code. Fonctionne de manière anonyme ou avec votre clé API.

[astroway_natal date="1990-06-15" time="14:30" lat="50.45" lon="30.52"]

Agents LLM / IA

Nous publions /llms.txt ↗ pour détecter les agents d'IA. La famille d'endpoints /v1/context/* renvoie un XML optimisé pour les LLM, directement consommable par les intégrations ChatGPT / Claude / Gemini.

Serveur MCP (Pro+)

Serveur natif Model Context Protocol sur mcp.astroway.info - connectez Claude Desktop ou tout client MCP pour interroger l'ensemble de l'API en mode conversationnel. Inclus dans les forfaits Pro et Business.