/api/astro/pdf/yearbook/25 créditsRapport PDF de l’année
Les douze prochains mois sous forme de PDF prêt à l’emploi, découpés par période de dasha. Le corps de la réponse EST le PDF (`application/pdf`) — un seul appel, rien n’est stocké. Là où /api/astro/pdf/horoscope/ décrit une nativité, ce rapport en décrit une année. L’horoscope reste le même document, que vous le génériez aujourd’hui ou dans dix ans ; celui-ci est lié à une date et devient obsolète — relancez-le l’an prochain et chaque page sera différente. L’ANNÉE N’EST PAS DÉCOUPÉE EN MOIS CIVILS. Elle est découpée selon la pratyantardasha de la Vimshottari — le 3e niveau de l’arbre des dashas —, si bien que chaque section commence et finit à une date dictée par ce thème. Une période peut donc durer trois semaines ou deux mois, et la première comme la dernière débordent généralement de la plage de douze mois, car une période est imprimée en entier ou pas du tout. Chaque période est lue sous l’angle des finances, de la carrière, de la vie familiale, de la vie amoureuse et conjugale, et de la santé, avec ce qu’il faut faire, ce qu’il faut éviter et les remèdes traditionnels propres au graha de la période. Le caractère porteur ou exigeant d’une période est déterminé d’après la dignité, la maison et la nature fonctionnelle du graha maître DANS CE THÈME, et les motifs sont imprimés à côté du verdict — deux personnes dans la même période de Vénus ne reçoivent donc pas la même page. DÉTERMINISTE. Chaque paragraphe est tiré d’une table, pas généré : les mêmes données de naissance et la même `start_date` produisent un livre identique à l’octet près, ce qui permet de répondre aux questions adressées au support. `start_date` vaut par défaut la date du jour. Passez le prochain anniversaire du natif pour obtenir un livre d’anniversaire à anniversaire plutôt qu’un livre glissant. Prend les mêmes données de naissance et le même bloc facultatif `branding` que le rapport d’horoscope. Deux en-têtes de réponse sont utiles : `X-Report-Periods` indique en combien de périodes de dasha l’année a été découpée, ce qui vous permet de distinguer un livre complet d’un livre incomplet sans l’ouvrir, et `X-Report-Sections-Failed` compte les calculs qui n’ont pas pu aboutir.
https://api.occultapi.com/api/astro/pdf/yearbook/Authentification
Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonChamps de la requête
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| latitude | number (double) | obligatoire | Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -90 · max 90 |
| longitude | number (double) | obligatoire | Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180 |
| ayanamsa | string | facultatif | |
| branding | object | facultatif | Coordonnées du revendeur imprimées sur la couverture, l’en-tête et le pied de page. |
| date_time | string (date-time) | facultatif | Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes. |
| day | integer | facultatif | Jour du mois sous forme de nombre, 1-31. min 1 · max 31 |
| gender | string | facultatif | |
| hour | integer | facultatif | Heure de naissance au format 24 heures, 0-23. Heure locale au lieu de naissance. min 0 · max 23 |
| minute | integer | facultatif | min 0 · max 59 |
| month | integer | facultatif | Mois de naissance sous forme de nombre, 1-12. Janvier vaut 1. min 1 · max 12 |
| name | string | facultatif | |
| place | string | facultatif | |
| start_date | string (date) | facultatif | Premier jour des douze mois à couvrir, YYYY-MM-DD. Par défaut : la date du jour. Passez le prochain anniversaire du natif pour obtenir un livre d’anniversaire à anniversaire plutôt qu’un livre glissant. |
| timezone_as_float | number (double) | facultatif | Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été. min -12 · max 14 |
| year | integer | facultatif | Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres. min 1800 · max 2200 |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/pdf/yearbook/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Ajeet Kanojia","gender":"male","date_time":"1985-02-23T05:45:00+05:30","latitude":20.8833,"longitude":76.2,"timezone_as_float":5.5,"place":"Malkapur, Maharashtra, India","start_date":"2026-01-01","branding":{"company_name":"Acme Astrology","company_info":"Vedic reports since 2011.","company_email":"hello@acme.example","domain_url":"https://acme.example","footer_link":"acme.example"}}'Réponse
Erreurs
Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.