FlutterFlow

FlutterFlow compile en une application que tient ton utilisateur, donc la question n’est pas quels champs remplir, mais où se retrouve la clé. La requête ci‑dessous a été envoyée en production exactement dans la forme que compose l’appel ; les étapes dans FlutterFlow sont écrites selon la documentation FlutterFlow en date du 2026‑09‑17.

Commence par créer une clé, comme décrit dans la section Clé pour l’automatisation, avec le scope chart.

Ключ у звичайному виклику їде разом із застосунком

Un appel qui n’est pas marqué comme privé s’exécute depuis l’appareil, et son en‑tête se trouve à l’intérieur du bundle compilé pour iOS, Android et le web, où il peut être lu par n’importe qui. Rends l’appel privé : alors FlutterFlow le fait passer par Firebase Cloud Function, et la clé reste sur le serveur. La vérification maison de FlutterFlow consiste à télécharger le code du projet et à chercher la clé dans les fichiers front‑end, et elle n’est disponible que sur le forfait payant.

1. Crée l’appel

Ouvre API Calls, clique sur + Add, sélectionne Create API Call et remplis :

• API Call Name: Natal chart.

• Method Type: POST.

• URL:

  https://api.astroway.info/v1/chart

• Onglet Headers, + Add Header : une ligne X-Api-Key: suivie de ta clé. Une deuxième ligne Content-Type: application/json.

• Onglet Variables : cinq variables de type String, date, time, timezone, latitude, longitude, chacune avec une valeur par défaut tirée du JSON ci‑dessous.

• Onglet Body, dans la liste déroulante JSON : colle le JSON et glisse‑y les variables.

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": "50.45",
  "longitude": "30.52"
}

Latitude et longitude restent des chaînes volontairement : l’API accepte "50.45" comme nombre, mais la chaîne simplifie le glisser‑déposer des variables.

Clique sur Add Call, ouvre Response & Test, clique sur Test API Call et regarde la réponse dans Test Response. data.input.timezoneOffset revient comme 4 : c’est exactement le décalage de Kyiv à cette date.

2. Rends l’appel privé

Dans Advanced Settings de l’appel, active Make Private, clique sur Save, puis sur Deploy APIs. Maintenant l’appel s’exécute dans Firebase Cloud Function, donc le projet a besoin d’un Firebase connecté et d’un forfait Firebase avec Cloud Functions.

Приватні виклики не успадковують заголовки групи

Si tu places la clé sur le API Group, et non sur l’appel lui‑même, FlutterFlow cessera de l’envoyer dès que l’appel devient privé : les en‑têtes du groupe ne sont pas hérités par les appels privés. Ajoute X-Api-Key sur l’appel lui‑même, sinon le premier lancement privé renverra 401.

Deux autres points que la documentation FlutterFlow indique clairement : la clé transmise depuis le front‑end, par exemple via remote config, reste exposée même dans un appel privé, et la forme sécurisée est l’en‑tête intégré directement dans l’appel.

3. Lis la réponse

Dans JSON Paths, clique sur + Add JSON Path et donne un nom à chacun :

Nom	JSON Path
ascendant	$.data.houses.ascendant
sunLongitude	$.data.planets[0].longitude
moonLongitude	$.data.planets[1].longitude
offsetUsed	$.data.input.timezoneOffset

Le signe est la longitude divisée par 30 et arrondie à l’inférieur, comme un indice dans une liste de douze noms : par exemple l’Ascendant 159.26 donne 5, c’est‑à‑dire Vierge. Une fonction personnalisée de quatre lignes ou une liste de douze lignes et l’indice suffisent.

La build web ne peut pas nous appeler depuis le navigateur

Mesuré le 2026‑09‑17 depuis une page sur un domaine tiers : POST /v1/chart répond au preflight sans l’en‑tête access-control-allow-origin, et Chrome bloque la requête. Le navigateur sur un domaine étranger ne reçoit que /v1/public/* et /v1/embed/*.

FlutterFlow fait passer les appels via son propre proxy dans le constructeur, en Run mode et Test mode, donc un appel qui fonctionne là‑bas peut échouer après la publication de l’application web. Deux solutions, et la première est recommandée :

• Rends l’appel privé, comme ci‑dessus. Alors il s’exécute dans Cloud Function, pas dans le navigateur, et cela résout immédiatement le problème de la clé et le problème CORS.
• Mets ton propre backend devant nous, si tu en as déjà un. La configuration du proxy dans FlutterFlow, avec ton propre proxy URL, est documentée pour le constructeur et les modes Run et Test ; la documentation ne dit rien sur la build web publiée, donc il ne faut pas compter sur eux.

La clé publique pk_ ne résout pas cela : elle ne récupère que /v1/public/* et /v1/embed/*, et les builds pour iOS et Android la rejettent complètement, car ils n’envoient pas de web‑origin.

Erreurs

• 401 sur un appel privé : la clé est sur le groupe, pas sur l’appel.
• 400 INVALID_FIELD avec timezone dans details : le fuseau est vide, c’est une abréviation comme EST ou pas un nom de zone.
• 400 avec date ou time dans details : le format n’est pas YYYY-MM-DD / HH:MM:SS.
• 403 ENDPOINT_NOT_IN_SCOPE : le scope de la clé ne contient pas chart.
• 429 KEY_BUDGET_EXHAUSTED : la clé a épuisé son budget ; augmente‑le dans le tableau de bord.

Note

Le forfait gratuit de FlutterFlow autorise deux API‑endpoints par projet et ne propose pas d’import OpenAPI, donc l’appel doit être ajouté manuellement, laissant un slot supplémentaire. L’API ne géocode pas : les coordonnées proviennent de tes propres champs ou d’un service de géocodage pour lequel tu possèdes une clé.