API d’astrologie pour sites web et applications

Avec les API d’AstroApp, votre site web ou votre application mobile peut demander un calcul astrologique à AstroApp et en afficher le résultat au sein de votre propre produit. Vous avez le choix entre trois familles d’intégrations d’API : les API REST, les extensions WordPress et Joomla, et les API JavaScript. Toutes tournent sur la même infrastructure qu’AstroApp, dans plusieurs centres de données, et sont capables de supporter durablement des millions de requêtes par jour. La marque blanche et la personnalisation à vos couleurs sont également proposées.

API REST

Vous envoyez les données du thème dans un appel REST et recevez en retour le calcul demandé. Les API REST couvrent les fonctionnalités d’AstroApp suivantes :

• les données du thème et les images du thème dans plusieurs styles de thème, occidentaux et védiques
• les planètes, les astéroïdes et les planétoïdes, les maisons et les aspects, en coordonnées géocentriques ou topocentriques, avec conversion sur demande des positions écliptiques en ascension droite et déclinaison
• les révolutions : solaires, lunaires et planétaires, les retours aux positions natales, à une position zodiacale donnée ou à une phase
• les transits à un thème natal et les transits aux transits
• les progressions secondaires et mineures, filtrées par période, et les progressions aux angles
• les ingrès dans les signes, les nakshatras, les mansions lunaires, les termes et les degrés du zodiaque
• l’état de la Lune : vide de course, mansion lunaire, nakshatra, la phase en cours et la suivante
• les dignités essentielles et accidentelles, 31 types en tout
• des statistiques par signe et par maison
• les données cartographiques AstroCartography
• les lieux et les fuseaux horaires : la recherche parmi plus de cinq millions de lieux par ville, hôpital ou nom de lieu, ou par proximité de coordonnées données. Chaque lieu fournit l’historique détaillé de ses changements de fuseau horaire

Vous pouvez vous authentifier par authentification Basic ou par jeton. Nous documentons chaque appel dans une collection Postman, avec un exemple complet dans 30 langages de programmation, dont cURL, PHP, Python, JavaScript, Node, Java et C : documentation de l’API REST d’AstroApp. Vous trouverez aussi sur GitHub un SDK Java, généré à partir des mêmes définitions.

API JavaScript

Utilisez les API JavaScript lorsque vous voulez un thème sur votre page web. Votre visiteur saisit les données de naissance, et le thème apparaît dans un style occidental ou védique, sans aucune programmation côté serveur nécessaire de votre part. La même bibliothèque vous donne aussi les données qui se trouvent derrière le thème :

• les planètes : longitude, latitude et vitesse des planètes principales, des astéroïdes, des planètes hypothétiques, de la Part de Fortune et des lunaisons prénatales
• les cuspides des maisons
• les aspects, avec l’indication appliquant ou séparant et la valeur exacte de chacun
• la base de données des villes et celle des changements de fuseau horaire, avec la possibilité de chercher par nom et par proximité de coordonnées

Certaines fonctions côté client ne nécessitent aucune requête : mi-points, aspect entre deux objets, positions en maison et en signe, distances et utilitaires de mise en forme. Vous pouvez limiter une clé à votre propre adresse web, afin que personne ne puisse la copier depuis votre page et l’utiliser ailleurs.

Clés et utilisation

Vous pouvez créer et gérer vos clés dans le portail d’utilisation des API de votre compte AstroApp. Vous pouvez aussi y suivre l’utilisation de vos API.

Les API JavaScript sont incluses dans les éditions Pro et Financial Gold (pour un usage personnel uniquement). Les API REST et les extensions pour CMS (Joomla et WordPress) sont un produit distinct, avec ses propres formules d’abonnement. Vous commencez avec un quota quotidien gratuit et un moyen de paiement enregistré, et votre compte passe automatiquement à la facturation à l’usage dès que vous dépassez pour la première fois votre quota quotidien gratuit. Pour vous inscrire, rendez-vous dans la section API de votre compte AstroApp, où les formules et les règles de facturation sont détaillées.

Questions fréquentes

Que renvoient les API ?

Du JSON pour chaque calcul, et une image lorsque vous demandez un thème. Les API JavaScript proposent aussi les mêmes données sous forme de flux XML si vous les préférez.

Faut-il un serveur pour utiliser les API JavaScript ?

Non. Le serveur est facultatif pour les API JavaScript, car elles peuvent fonctionner sur n’importe quelle page HTML statique. Quant aux API REST, vous les utilisez depuis votre propre serveur ou votre application, dans n’importe quel langage de programmation capable d’envoyer une requête HTTP.

Puis-je afficher le thème dans un style védique ?

Oui. Les images de thème et les roues JavaScript existent en styles occidentaux et védiques, et les calculs acceptent l’ayanamsa et les vargas des paramètres védiques.

Proposez-vous une base de données des lieux et des emplacements géographiques ?

Oui. Vous pouvez chercher parmi plus de cinq millions de lieux par nom et par proximité de lieux géographiques donnés, et les recherches peuvent être filtrées par pays et par État. L’historique de chaque changement de fuseau horaire est inclus, si bien qu’un thème à une date passée utilise les règles horaires en vigueur à cette date.

Puis-je présenter les résultats sous ma propre marque ?

Oui. La marque blanche et la personnalisation à vos couleurs sont proposées.

Voir aussi

• Documentation de l’API REST d’AstroApp
• Styles de roue, les styles de thème que vous pouvez utiliser dans une image fournie par l’API
• Prévision, pour les révolutions, transits et progressions que calculent les API

Comparer les éditions et les prix.