Questions fréquentes

Combien coûte un appel ?

Un crédit par appel réussi, quel que soit le volume renvoyé. Exceptions : les endpoints de rapport PDF et de chat IA, à 25 crédits l’appel. Une requête pour un calcul coûte autant qu’une requête pour quarante : beaucoup d’endpoints acceptent un tableau `keys`, et toutes les clés d’une même requête sont couvertes par ce seul crédit.

Les requêtes en échec sont-elles facturées ?

Non. Occult API ne facture jamais une requête en échec. Le crédit est réservé avant le calcul, puis libéré si celui-ci n’aboutit pas proprement : une erreur 4xx, 5xx ou un délai dépassé ne coûte rien, et une intégration en cours de débogage ne peut pas vider votre solde. Chaque réponse indique son coût réel dans l’en-tête X-Credits-Charged.

Les crédits expirent-ils ?

Le quota d’une formule est remis à zéro chaque mois. Occult API est vendue sous forme de formules mensuelles ou annuelles : chaque mois apporte un nouveau quota, et les appels non utilisés dans le mois ne sont pas reportés sur le suivant. Les formules annuelles fonctionnent de la même façon : douze allocations mensuelles, facturées en une fois.

Existe-t-il une offre gratuite ?

Les nouveaux comptes reçoivent des crédits offerts, utilisables sur l’API réelle avec une vraie clé, et non dans un bac à sable avec ses propres données. Par ailleurs, le Playground (occultapi.com/playground) envoie de vrais appels à l’API en service avec votre propre clé, et un appel en échec n’y coûte rien.

Faut-il un abonnement ?

Oui. Occult API est vendue sous forme de formules mensuelles ou annuelles qui se renouvellent automatiquement jusqu’à ce que vous les résiliiez. La résiliation arrête le prochain renouvellement, et la période en cours reste utilisable jusqu’à son terme. Aucun palier ne masque d’endpoint : chaque formule peut appeler tous les endpoints.

Je reçois une erreur 402. Ma clé est-elle invalide ?

Non. Une erreur 402 avec le message insufficient_credits signifie que la clé API est valide mais que le quota est épuisé. Régénérer la clé n’y changera rien : passez à une formule supérieure ou attendez la remise à zéro mensuelle. Seule l’erreur 401 invalid_api_key signale un problème avec la clé elle-même.

Puis-je utiliser une clé API dans le navigateur ou une application mobile ?

Non. Une clé Occult API est un secret côté serveur. Placée dans du JavaScript front-end ou dans le paquet d’une application mobile, elle peut être lue par quiconque installe l’application ou ouvre les outils de développement, qui pourra alors dépenser votre solde. Appelez l’API depuis votre propre serveur et exposez votre propre endpoint au client.

J’ai perdu ma clé. Pouvez-vous me la renvoyer ?

Non, et c’est voulu. Occult API ne conserve les clés que sous forme d’empreintes SHA-256 : ni un administrateur ni une copie de la base de données ne peuvent en retrouver une. Créez une nouvelle clé et révoquez l’ancienne. La révocation est immédiate et n’a aucun effet sur le solde de crédits.

Que faire si une clé a fuité ?

Révoquez-la depuis la page des clés : la révocation est immédiate. Chaque clé porte un préfixe public de huit caractères, indexé justement pour qu’une clé publiée par erreur dans un dépôt public puisse être retrouvée et révoquée à partir de ce seul préfixe, sans que personne n’ait besoin de la partie secrète.

D’où viennent les calculs ?

Occult API calcule à partir des éphémérides NASA JPL : le jeu de données complet, avec 735 étoiles fixes, de 500 à 2999 apr. J.-C. Rien n’est lu dans un almanach précalculé : chaque réponse est calculée pour l’instant et les coordonnées exacts de la requête.

Votre résultat diffère d’une autre source. Pourquoi ?

La cause habituelle est l’ayanamsa. Les traditions indiennes ne sont réellement pas d’accord à son sujet, et un écart d’un degré peut faire passer une planète d’un nakshatra à l’autre. Occult API propose 48 ayanamsas, chacun corrigeable en degrés, minutes et secondes. Vérifiez donc d’abord que les deux sources utilisent le même.

Quelle est sa rapidité ?

Le temps de réponse médian côté serveur est de 62 ms, mesuré sur tous les exemples publiés et non sur un cas choisi. Quelques endpoints effectuent des analyses lourdes, comme un balayage complet du varshaphal ou une année de raasi dasha, et prennent plusieurs secondes. La référence le signale clairement, au lieu de le noyer dans la médiane.

Existe-t-il une spécification OpenAPI ou un SDK ?

Occult API publie un document OpenAPI 3.1 sur occultapi.com/openapi.json. Il est généré à partir du même catalogue que la documentation et contient un exemple pour chaque opération : 255 des 299 proviennent d’un serveur en service, les autres sont dérivés du schéma de requête. Avec openapi-generator ou un outil équivalent, vous obtenez un client typé dans le langage de votre choix. Une collection Postman et un serveur MCP pour les assistants IA sont aussi disponibles.

Un assistant IA peut-il l’appeler ?

Oui. Occult API publie un serveur MCP qui expose tous les endpoints via cinq outils. Rechercher des endpoints et lire les schémas de requête ne coûte aucun crédit, seul un vrai calcul est facturé : un assistant peut donc explorer toute l’API avant de dépenser quoi que ce soit. Des consignes pour les agents de code sont publiées sur occultapi.com/AGENTS.md.

Puis-je vendre ce que renvoie l’API ?

Oui. Occult API vous accorde une licence libre de redevances pour exploiter commercialement les données dans vos propres produits : stocker les réponses dans votre base de données, générer et vendre des rapports, les utiliser pour vos clients. Aucune mention de la source n’est exigée. Ce qui est interdit, c’est de revendre l’accès à l’API elle-même, sous forme d’API.

Conservez-vous les données de naissance que j’envoie ?

Non. La date, l’heure et le lieu d’une requête servent à calculer la réponse et ne sont pas enregistrés en base de données ensuite. Pour chaque appel, nous conservons l’endpoint, l’horodatage, le statut HTTP et les crédits consommés : c’est ce qu’exigent les rapports d’utilisation et les questions de facturation.

Proposez-vous un DPA ?

Oui. Occult API publie un accord de traitement des données (DPA) qui couvre l’article 28 du RGPD, ainsi qu’une liste à jour des sous-traitants qui nomme chaque tiers pouvant accéder aux données des clients.

Si votre question n’y figure pas, écrivez à mridul.kabra23@gmail.com. Pour ce que nous avons mesuré ou non, consultez la méthodologie ; pour ce que nous stockons et ce que nous n’avons pas développé, la page transparence. Les codes d’erreur sont tous listés dans la section authentification, avec l’explication de pourquoi une erreur 402 n’est pas un échec d’authentification.