Utiliser la collection Postman

Toutes les requêtes de la collection sont authentifiées : il vous faut une clé avant d’obtenir la moindre donnée. Créer une clé est gratuit ; vous ne dépensez des crédits que lorsqu’un appel réussit.

1. 1Créez un compte sur occultapi.com/signup et confirmez votre adresse e-mail.
2. 2Ouvrez API keys dans le tableau de bord et cliquez sur Create key.
3. 3Copiez la clé immédiatement. Elle ne s’affiche qu’une fois et elle est stockée sous forme d’empreinte : personne, pas même nous, ne peut vous la remontrer. Si vous la perdez, vous la renouvelez ; impossible de la récupérer.

La collection est publique : rien à importer. Le lien l’ouvre dans votre navigateur, avec tous les dossiers, requêtes et réponses déjà consultables. Pas besoin de compte Postman pour la lire.

Les requêtes sont regroupées comme dans la référence : Panchang, Muhurta, Dashas, Charts, Calendars, etc. Chacune reprend la description de la documentation et le corps qui a servi à capturer son exemple de réponse.

Lire la collection ne demande aucun compte, mais pour envoyer une requête il vous faut votre propre copie. Un fork vous la donne.

1. 1Connectez-vous à Postman, ou créez un compte gratuit.
2. 2Cliquez sur Fork Collection en haut de la collection, ou sur l’icône de fork à côté de son nom.
3. 3Donnez un libellé au fork — votre nom suffit — et choisissez l’espace de travail où le placer.
4. 4Laissez Watch original collection coché. C’est ce qui vous permettra de récupérer les nouveaux endpoints plus tard, sans refaire de fork.
5. 5Cliquez sur Fork Collection. Votre copie s’ouvre, et rien de ce que vous y modifiez n’affecte la nôtre.

Vous préférez vous passer de compte Postman ? Téléchargez le JSON et utilisez plutôt Import dans l’application de bureau Postman. Vous perdez alors le lien de mise à jour : il faudra réimporter quand l’API gagnera des endpoints.

Ouvrez l’onglet Variables de la collection. Il y en a deux : baseUrl, déjà réglée sur https://api.occultapi.com, et apiKey, vide. Collez votre clé dans la valeur d’apiKey et enregistrez.

C’est la seule étape d’authentification. Chaque requête de la collection hérite de la clé définie ici et l’envoie dans l’en-tête X-API-Key : vous la saisissez une fois, et non 299 fois. Si vous n’avez pas encore de clé, créez-en une depuis votre tableau de bord.

Toutes les requêtes sont en POST avec un corps JSON, et l’URL utilise {{baseUrl}} : vous ne tapez jamais l’hôte. La description de chaque requête reprend le texte de sa page dans la référence.

1. 1Dépliez un dossier dans la barre latérale — Astrology / Dasha est un bon point de départ — et cliquez sur une requête.
2. 2Vérifiez que l’onglet Authorization indique un héritage depuis la collection. Il s’agit de l’apiKey que vous venez de définir ; vous n’ajoutez aucun en-tête vous-même.
3. 3Cliquez sur Send. Le corps contient déjà des valeurs valides : le premier appel fonctionne sans rien modifier.

Ouvrez l’onglet Body et modifiez les valeurs. Quatre champs portent l’essentiel de ce dont un thème a besoin. Une erreur sur l’un d’eux provoque rarement un message d’erreur : le plus souvent, la réponse est juste subtilement fausse.

1. 1date_time — au format ISO 8601, et incluez toujours le décalage (+05:30) ou un Z final. Une valeur sans fuseau est lue comme Asia/Kolkata, ce qui décale le thème sans prévenir pour toute personne hors d’Inde.
2. 2latitude et longitude — en degrés décimaux, pas en degrés et minutes. Attention au signe : un moins oublié place New York en Chine.
3. 3timezone_as_float — le décalage en heures, sous forme décimale. 5.5 pour l’Inde, -5 pour New York.
4. 4Cliquez sur Beautify si le JSON devient brouillon, puis renvoyez la requête avec Send.

Le panneau de réponse s’ouvre en dessous. Le corps contient les données ; les en-têtes indiquent l’effet de l’appel sur votre solde.

1. 1Body — le JSON. Tout se trouve sous une clé data, à côté de message et is_error.
2. 2Headers — X-Credits-Cost est le tarif de cet endpoint, X-Credits-Charged ce qui vous a réellement été facturé, et X-Credits-Remaining votre solde après l’appel.
3. 3Charged vaut 0 à chaque échec : corps mal formé, date invalide, erreur de notre côté. Expérimentez librement : vous ne payez que les appels qui ont renvoyé des données.
4. 4Cliquez sur Save as example pour conserver une réponse avec la requête : votre équipe en voit la structure sans dépenser de crédit.

Une fois la requête au point, Postman l’écrit pour vous dans votre langage. Ouvrez l’icône </> Code dans la barre de droite et choisissez cURL, Python, Node, PHP, Go ou un autre.

L’extrait remplace {{baseUrl}} par le vrai hôte et inclut l’en-tête X-API-Key : il fonctionne tel quel. Remplacez la clé par une variable d’environnement avant de commiter, car l’extrait contient un secret actif.

Le bouton Run, en haut d’une collection ou d’un dossier, envoie toutes ses requêtes dans l’ordre. Pratique pour vérifier qu’une clé fonctionne sur toute une catégorie, ou comme test rapide après une modification.

N’oubliez pas que chaque appel réussi consomme un crédit : exécuter les 299 requêtes coûte 299 crédits — et même davantage, puisque l’endpoint de chat et les deux rapports PDF coûtent 25 crédits chacun. Exécutez un dossier plutôt que toute la collection, sauf si c’est voulu.

La collection est générée à partir du même catalogue que la documentation : elle gagne des endpoints en même temps que l’API.

1. 1Postman propose une option pull changes sur votre fork quand l’original a évolué.
2. 2En l’acceptant, vous récupérez les nouvelles requêtes sans toucher aux corps que vous avez modifiés ni aux variables que vous avez définies.
3. 3Le journal des modifications indique ce qui a été ajouté et quand : vous savez si une mise à jour vaut la peine.