Aller au contenu
AstroWay/api v2.325.0 · fr
tous les systèmes sont opérationnels

Intégrations sans code

Tout sur ces pages a été exécuté contre la production du 2026-09-17. Les workflows pour n8n ont été importés et exécutés dans un vrai n8n ; les étapes pour Zapier et Make ont été écrites en suivant la documentation propre à ces outils, et les requêtes qu’ils composent ont été envoyées telles quelles.

Le type de clé nécessaire en dépend.

  • Zapier, Make et n8n l’envoient depuis leurs serveurs. Une clé “Serveur uniquement” est requise, avec une portée d’endpoints et un budget, comme décrit ci-dessous. Instructions : Zapier, Make, n8n.
  • Bubble envoie également des requêtes depuis ses serveurs, et la clé se trouve dans l’en-tête, où elle reste : Bubble.
  • FlutterFlow compile en une application détenue par l’utilisateur, l’appel doit donc être privé : FlutterFlow.
  • Wix, Squarespace, Shopify, Webflow et Tilda affichent la page dans le navigateur du visiteur. Insère un widget, pas une clé : constructeurs de sites web.
  • WordPress effectue des requêtes depuis ton propre serveur. Le plugin AstroWay gère la clé.

Quiconque peut modifier un Zap, un scénario ou un workflow voit la clé à l’intérieur. Donne donc à chaque automatisation sa propre clé et limite-la à ce qu’elle fait.

  1. Dans le tableau de bord, ouvre Clés API et clique sur Nouvelle clé. Nomme-la d’après l’automatisation, par exemple zapier-intake-form.
  2. Dans le champ Où cette clé sera-t-elle utilisée ?, laisse Serveur uniquement.
  3. Copie la clé et enregistre-la : la boîte de dialogue l’affiche entièrement une seule fois. Si la clé est perdue, clique sur Renouveler la clé dans le menu de la clé : tu en obtiendras une nouvelle, l’ancienne cessera de fonctionner.
  4. Dans le menu de la clé, ouvre Portée des endpoints et liste les chemins que l’automatisation appelle, un par ligne : chart pour un thème natal, public/horoscope/* pour les horoscopes quotidiens.
  5. Dans le même menu, ouvre Définir le budget et indique combien de crédits cette clé peut dépenser par cycle.

Un appel hors de la liste reçoit un 403 ENDPOINT_NOT_IN_SCOPE. Une clé qui a épuisé son budget reçoit un 429 KEY_BUDGET_EXHAUSTED, même si le compte a encore des crédits, donc une automatisation qui boucle s’arrêtera au nombre spécifié. Les deux restrictions fonctionnent sur n’importe quel plan tarifaire et sont décrites dans la section Authentification.

Envoie le moment de la naissance, pas le décalage

Section intitulée « Envoie le moment de la naissance, pas le décalage »

Le formulaire fournit la date, l’heure de l’horloge et le lieu. Envoie-les comme suit :

{
"date": "1990-05-15",
"time": "14:30:00",
"timezone": "Europe/Kyiv",
"latitude": 50.45,
"longitude": 30.52
}
  • timezone est le nom du fuseau horaire, et le serveur trouve lui-même le décalage UTC que les horloges affichaient à cette date, y compris l’heure d’été. Kiev le 1990-05-15 était en UTC+4, et non +3 : c’est l’erreur que donne un décalage entré manuellement. Envoie auto pour prendre le fuseau horaire à partir des coordonnées.
  • Sans timezone et sans décalage, le thème est calculé pour l’UTC. La réponse est toujours 200, alors vérifie que le champ est mappé.
  • Un timezone vide est rejeté avec un 400, car sinon un champ de formulaire non rempli serait interprété comme UTC.
  • date au format YYYY-MM-DD, time au format HH:MM:SS. Si le formulaire les stocke différemment, utilise le formatage de date de l’outil lui-même.
  • Les nombres peuvent arriver sous forme de texte. "latitude": "50.45" est accepté, et c’est ainsi que la plupart des champs de formulaire les envoient.
  • L’API ne géocode pas. Les coordonnées doivent provenir du formulaire ou d’une étape de géocodage dans l’outil. Le champ city n’est qu’une étiquette.

Les règles pour les changements d’heure et les dates antérieures à 1970 sont décrites dans les formats de champs.

POST /v1/chart répond en degrés le long du zodiaque, dans une enveloppe { "ok": true, "data": { ... } }. Le signe est égal à floor(longitude / 30), en comptant à partir de zéro :

0 Bélier, 1 Taureau, 2 Gémeaux, 3 Cancer, 4 Lion, 5 Vierge, 6 Balance, 7 Scorpion, 8 Sagittaire, 9 Capricorne, 10 Verseau, 11 Poissons.

Où se trouvent les trois valeurs les plus populaires :

  • Soleil : entrée dans data.planets avec "name": "Sun", la première.
  • Lune : entrée dans data.planets avec "name": "Moon", la deuxième.
  • Ascendant : data.houses.ascendant.
  • Décalage utilisé : data.input.timezoneOffset.

Pour l’exemple ci-dessus : Soleil 54.34, donc Taureau ; Lune 296.39, Capricorne ; Ascendant 159.26, Vierge ; décalage 4.

  • POST /v1/chart coûte 20 crédits. Le tableau complet se trouve sur la page Coût des endpoints.
  • La même requête, envoyée à nouveau dans les cinq minutes, est renvoyée depuis le cache et n’est pas facturée. Un test qui répète le même corps ne consomme pas de budget.
  • GET /v1/public/horoscope/daily ne consomme pas de crédits. Sans clé ou avec une clé sur le plan Free, il est compté dans la limite de 30 requêtes par heure par adresse IP, et les plateformes d’automatisation partagent leurs adresses entre les clients. Une clé sur un plan payant a sa propre limite.