# Zapier

Zap, qui prend la date, l'heure, le fuseau et les coordonnées de naissance du déclencheur, interroge l'API pour obtenir la carte et transforme l'Ascendant en nom du signe. La requête ci-dessous a été envoyée en production exactement sous la forme dans laquelle l'étape la construit ; les étapes dans Zapier sont écrites selon la documentation Zapier en date du 2026-09-17.

<Aside type="caution" title="Un forfait payant Zapier est requis">
API by Zapier, Webhooks by Zapier et Formatter sont des applications premium. La documentation Zapier indique que les trois ne sont pas disponibles sur le forfait Free, et l'étape Lookup Table nécessite un forfait Professional ou supérieur. Sur Free, utilisez [Make](/integrations/make/) ou [n8n](/integrations/n8n/).
</Aside>

Sperшу créez une clé, comme décrit dans la section [Clé pour l'automatisation](/integrations/#ключ-для-автоматизації), avec la portée `chart`.

## 1. Placez la clé dans la connexion
Les en-têtes saisies dans l'étape Webhooks by Zapier sont stockées dans l'étape elle-même, et elles sont visibles par quiconque a accès au Zap. API by Zapier les conserve dans la connexion.

1. Sur la page **Apps**, cliquez sur **+ Add connection** et sélectionnez **API by Zapier**.
2. **Type d'authentification** : En-têtes statiques (clé API).
3. **En-têtes** : `X-Api-Key: ` suivi de votre clé, sur une seule ligne.
4. **Filtre de domaine** : `api.astroway.info`, afin que la connexion ne puisse pas être redirigée ailleurs.

## 2. Appelez la carte
Ajoutez une action, sélectionnez **API by Zapier**, l'événement **API Request** et la connexion.

- **Méthode** : `POST`.
- **URL**:

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

- **Corps** : JSON ci-dessous avec les champs du déclencheur à la place des valeurs.

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

Remplacez chaque valeur par le champ correspondant du déclencheur et laissez les guillemets autour de chacun, les nombres aussi. Zapier insère le champ mappé sous forme de texte simple et n'ajoute pas de guillemets, tandis que l'API accepte `"50.45"` comme nombre. Ne ajoutez pas la clé dans les en-têtes de l'étape : elle est fournie par la connexion.

Testez l'étape. La réponse correcte commence par `"ok": true`, et `data.input.timezoneOffset` pour l'exemple vaut `4` : le décalage que Kiev avait ce jour-là.

## 3. Convertissez l'Ascendant en signe
Deux étapes Formatter.

**Formatter, événement Numbers, conversion de formule de style feuille de calcul.** Formule :

```
FLOOR(ASCENDANT / 30)
```

où `ASCENDANT` est remplacé par `data.houses.ascendant` de l'étape 2. Pour l'exemple, cela donne `5`.

**Formatter, événement Utilities, conversion de table de recherche.** La clé de recherche est le résultat de la formule. Tableau :

| Clé | Valeur |
|---|---|
| 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 |

Pour l'exemple, le résultat est `Virgo`. Pour obtenir les noms français, écrivez-les dans la colonne Valeur.

Le Soleil et la Lune sont calculés de la même manière. Ce sont le premier et le deuxième enregistrement dans `data.planets`, chacun ayant sa propre `longitude` : par exemple 54.34 (Taureau) et 296.39 (Capricorne).

## Si vous utilisez Webhooks by Zapier
Cela fonctionne, mais la clé se trouve dans l'étape, et non dans la connexion. Pour la carte, sélectionnez l'événement **Custom Request** : il envoie le champ Data exactement tel qu'il est saisi, donc le JSON ci-dessus sera envoyé sans modification. Définissez **Method** `POST`, et dans **Headers**, ajoutez à la fois `X-Api-Key` avec votre clé, et `Content-Type` avec la valeur `application/json`.

## Lorsque l'étape échoue
- **`400 INVALID_FIELD` avec `timezone` dans `details`** : la zone correspondante est vide, il s'agit d'une abréviation telle que `EST` ou ce n'est pas un nom de fuseau.
- **`400` avec `date` ou `time` dans `details`** : le format du déclencheur n'est pas `YYYY-MM-DD` / `HH:MM:SS` ; ajoutez avant l'appel une étape Formatter pour la date.
- **`403 ENDPOINT_NOT_IN_SCOPE`** : la portée de la clé ne contient pas `chart`.
- **`429 KEY_BUDGET_EXHAUSTED`** : la clé a épuisé son budget ; augmentez-le dans le tableau de bord.

L'API ne effectue pas de géocodage. Si le déclencheur ne fournit que le nom du lieu, les coordonnées doivent provenir du déclencheur lui-même ou d'un service de géocodage auquel vous avez une clé.