Retour à la documentation

Recherche d’entrées exactes

Recherche d’entrées exactes

POST/api/v1/western/progressions/{system}/exact-ingresses

Recherchez les entrées en signe ou en maison d’un système de progression sur une période. Les résultats contiennent les événements exacts, et non des thèmes complets.

Cet endpoint nécessite x-api-key. L’exemple ci-dessous est une requête authentifiée complète.

Fonctionnement

Lorsque ingress_type vaut both, la recherche donne par défaut la priorité aux signes : toutes les entrées en signe sont recherchées, tandis que les entrées en maison sont réduites pour respecter la limite commune, sauf si vous demandez explicitement ingress_type="house".

Les périodes de recherche sont limitées pour préserver les performances : jusqu’à 3 ans pour les secondaires et secondaires converses, 2 ans pour les tertiaires, et 1 an pour les quotidiennes et quaternaires.

Systèmes pris en charge

Ce modèle de recherche d’entrées exactes fonctionne pour les cinq systèmes. Remplacez {system} par secondary, converse-secondary, tertiary, quotidianou quaternary.

Exemple de requête

curl -X POST "https://api.freeastroapi.com/api/v1/western/progressions/secondary/exact-ingresses" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "name": "User",
    "datetime": "1984-05-12 08:30",
    "time_known": true,
    "location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "AUTO"
    }
  },
  "search": {
    "from": "2026-03-30",
    "to": "2027-03-30"
  }
}'

Exemple de réponse réelle de l’API

Réponse enregistrée depuis l’API en production le 14 avril 2026 avec la requête ci-dessus.

{
  "meta": {
    "endpoint": "exact_ingresses",
    "version": "v1",
    "system": "secondary",
    "zodiac_type": "tropical",
    "house_system": "placidus",
    "generated_at": "2026-04-14T15:55:26Z"
  },
  "window": {
    "from": "2026-03-30",
    "to": "2027-03-30",
    "limit": 100,
    "order": "asc"
  },
  "events": [
    {
      "event_date": "2026-12-28T18:28:07Z",
      "point": "moon",
      "ingress_type": "sign",
      "from_sign": {
        "name": "Aries",
        "index": 0,
        "abbr": "Ari"
      },
      "to_sign": {
        "name": "Taurus",
        "index": 1,
        "abbr": "Tau"
      },
      "target_datetime_utc": "2026-12-28T18:28:07Z",
      "basis": {
        "age_years_decimal": 42.6305,
        "progressed_days_after_birth": 42.6305,
        "natal_datetime_utc": "1984-05-12T07:30:00Z",
        "progressed_datetime_utc": "1984-06-23T22:37:55Z"
      },
      "interpretation_key": "progressed_moon_ingress_taurus"
    }
  ]
}

Documentation associée

Vue d’ensemble des progressionsAspects exacts