Welcome to Astrology API#
This API is created by a professional astrologer to serve professional commercial astrological apps (frontends). Most API endpoints are protected against public use. They are specially designed for the commercial frontend apps we develop and support, and are not intended to be used publicly.
Note
This documentation has been developed solely for internal use by our frontend development and support team.
Access levels to this API#
There are several levels of access to this API
- Level
0
. This is the basic access level. We provide the data necessary for the visualization of the astrological chart in the Regiomonranus/Placidus system, including the charts at extreme latitudes. - Level
1
. This is an advanced level of access to the analysis of horary charts. - Level
2
. This level includes data for the analysis of horary charts, as well as for the analysis of medical horary questions. - Level
m1
. This level includes data for the analysis of natal charts by the methods of the 17th century astrologer - Morinus, including data for the visualization of a three-dimensional horoscope and primary directions.
Below is a table of correspondence between endpoints and the access levels they support
User Authentication#
Endpoint | Level | Comment |
---|---|---|
/api/auth/verify-jwt |
0 , 1 , 2 , m1 |
Verifies end-user access token |
/api/auth/obtain-jwt |
0 , 1 , 2 , m1 |
Starts end-user session by providing access token |
Astrology Data Endpoints#
Endpoint | Level | Comment |
---|---|---|
/api/horary/ |
0 , 1 , 2 |
Provides astrology data for analysing a horary chart |
/api/natal/ |
m1 |
Provides astrology data for analysing a natal chart |
Astrology Reading Endpoints#
Endpoint | Level | Comment |
---|---|---|
/api/reading/stones/<slug>/ |
$ per request | Selects gemstones to improve different areas of life |
/api/reading/feelings/ |
$ per request | Answers the question ... |
Horary Chart Saving in the Cloud#
Horary Chart Sharing#
Endpoint | Level | Comment |
---|---|---|
/api/share/verify |
0 , 1 , 2 |
Veryfies the horary chart sharing link |
/api/share/newlink |
0 , 1 , 2 |
Generates new link to share a horary chart |