POST/api/astro/pdf/horoscope/25 crédits

Rapport PDF d’horoscope

Un horoscope védique complet sous forme de PDF prêt à l’emploi, en un seul appel. Le corps de la réponse EST le PDF (`application/pdf`) — pas de seconde requête, pas de fichier hébergé. Plus de quarante pages : données de naissance et panchang, positions planétaires avec les maîtres des nakshatras, le thème du lagna en style nord-indien et sud-indien, le thème lunaire, douze thèmes divisionnaires, les cuspides des maisons, les amitiés planétaires, les placements KP, le Sarvashtakavarga plus une page de Bhinnashtakavarga pour chaque graha, trois systèmes de dashas avec la période en cours détaillée en sous-périodes, les résultats Kala Sarpa et Manglik, la chronologie complète de la Sade Sati avec ses passages Ardha Kantaka et Ashtama Shani, la numérologie, des recommandations de pierres précieuses, de rudraksha et de mantras, et une lecture pour chacun des neuf grahas. NOUS NE STOCKONS RIEN. Les API de rapports écrivent généralement le fichier dans un bucket et renvoient un lien : un thème natal — un nom, une heure de naissance, un ensemble de prévisions — reste alors accessible à une URL publique tant que l’objet existe. Ici, les octets vous sont renvoyés directement. Rien n’est écrit de notre côté, et il n’existe aucun lien que quelqu’un d’autre pourrait trouver. Si vous voulez une copie hébergée, enregistrez ces octets vous-même, avec votre propre durée de conservation et vos propres règles d’accès. MARQUE BLANCHE. Tout ce qui figure dans `branding` est facultatif et apparaît sur la couverture, l’en-tête courant et le pied de page : votre client voit votre nom. Le document ne porte nulle part le nôtre. LE MOMENT DE NAISSANCE. Envoyez soit `date_time` en ISO 8601, soit les champs séparés `day`/`month`/`year`/`hour`/`minute` avec `timezone_as_float`. Si vous envoyez les deux, la requête est rejetée plutôt que tranchée à votre place : lorsque les deux divergent, aucun choix n’est sûr, et le résultat serait un thème faux présenté avec assurance. Chaque valeur est calculée par les endpoints mêmes de cette API — les positions de la page 3 sont exactement celles que renvoie /api/astro/planet-positions/. Chaque section peut échouer indépendamment des autres : si un calcul n’est pas défini pour un thème, la page concernée l’indique et le reste du rapport est quand même produit. L’en-tête de réponse `X-Report-Sections-Failed` en donne le nombre, ce qui vous permet de distinguer un rapport complet d’un rapport incomplet sans l’ouvrir. De bout en bout, la génération prend généralement moins de deux secondes.

https://api.occultapi.com/api/astro/pdf/horoscope/

Tester la requête

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/json

Champs 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.
chart_style	string	facultatif	Style de diagramme du thème natal. Les deux sont inclus par défaut. `northsouthboth`
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
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/horoscope/ \
  -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","chart_style":"both","branding":{"company_name":"Acme Astrology","company_info":"Vedic reports since 2011.","company_email":"hello@acme.example","company_mobile":"+91 90000 00000","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.