Creates a XML astrology report.
All fields starting with P1- need to be duplicated and changed to P2- to add a second person for relationship reports.
Request Parameters | ||
---|---|---|
ReportCode | Required | Defines which report is to be created. The ReportCode is part of the service address. /v2/reports/CreateXML/ReportCode/ |
APIKey | Required | A valid API Key for your user account. Provided in setup email |
P1FirstName | Required | First name for person |
P1LastName | Optional | Last name for person |
P1Sex | Required | Single letter code : M for male, F for female |
P1DOB | Required | YYYY-MM-DD format. Add zeros to single digit months or days. Example: 1970-06-27, 2011-12-09 |
P1TimeUnknown | Optional | 1 for time unknown 0 or leave blank for time known (and add time to P1Time) |
P1Time | Required | 24 hour hh:mm format, add zeros to single digit hours. Example: 13:26, 09:07 Time is not required if P1TimeUnknown is set to 1 |
P1LocationCode | Required | Unique location of birth code. You must use CheckLocation before calling this method to collect this code |
P1CurrentLocationCode | Optional | Unique current location city code. You must use CheckLocation before calling this method to collect this code. Only required for some forecast reports. |
ForecastDate | Optional | Start date for forecast reports. YYYY-MM-DD format. Add zeros to single digit months or days. Example: 2018-12-09 |
OrderID | Optional | Your own order ID, add if you want to track your orders against our billing system. |
ImageSize | Optional | Width / Height in pixels of astrology images such as the chartwheel. Defaults to 400px with no value supplied. Maximum value 2500. Supply number only 500 not 500px |
TestMode | Optional | Enable test mode by setting field to 1. Test mode allows creation of reports without being billed for the report. |
OutputFormat | Optional | Default response format is set to XML, select JSON by adding outputformat=JSON to any request. |
Responses | ||
---|---|---|
ResponseStatus | ||
Code | Code representing errors see result codes to determine the error. | |
Message | Description of the error | |
ResponseData | ||
XML | XML Astrology Report | |
AdditionalData | Extra astrological data included in some reports. |
CreateXML Result codes
Positive result code indicates success, negative shows a failure.
Success Codes
1 OK – Created report
Input Errors – Person 1
-11 Error – Missing first name
-12 Error – Sex not provided or invalid
-13 Error – Missing date of birth
-14 Error – Invalid date of birth
-15 Error – Missing time of birth (set P1TimeUnknown to 1 if time is unknown)
-16 Error – Invalid time of birth
-17 Error – Missing location code
-18 Error – Invalid location code
-19 Error – Invalid current location code
Input Errors – Person 2
-21 Error – Person 2 – Missing first name
-22 Error – Person 2 – Sex not provided or invalid
-23 Error – Person 2 – Missing date of birth
-24 Error – Person 2 – Invalid date of birth
-25 Error – Person 2 – Missing time of birth (set P2TimeUnknown to 1 if time is unknown)
-26 Error – Person 2 – Invalid time of birth
-27 Error – Person 2 – Missing location code
-28 Error – Person 2 – Invalid location code
-29 Error – Person 2 – Invalid current location code
Action Errors
-31 Error – Invalid or Expired ReportID
-32 Error – Invalid or ForecastDate
API Key Errors
-41 Error – Missing API Key
-42 Error – Invalid or expired API Key
System Errors
-91 Error – System error – retry later.
Example Request
Creating a XML report for the following birth details:
First Name : John
Last Name : Smith
Sex : Male
Date of Birth : 15th June 1970
Time of Birth : 6:20 PM
Location : Orlando, Florida
In this example PRO-ST-CHART is the ReportCode
/v2/reports/CreateXML/PRO-ST-CHART/?&APIKEY=YOURAPIKEY&P1FirstName=John&P1LastName=Smith&P1Sex=M&P1DOB=1970-06-15&P1Time=18:20&P1LocationCode=7842193
Example Response
<CreateXMLResponse>
<ResponseData>
<AdditionalData i:nil = "true"/>
<XML><Report><Settings Name="Free Chart Wheel"/><ReportIntro><Heading>Free Chart Wheel</Heading><Body>Welcome to your Cosmic Wheel report - a detailed introduction to your astrological profile. This report explains the essence of the Sun and Moon's position as well as some of the other planets and important points in your Birth Chart. Although this report, based on the time, if given, and place of your birth, is as accurate as is possible, it is inevitable that not everything will apply to you, personally. The planets in their courses reveal your potential, as well as the crossroads and signposts you will encounter on your personal voyage through life. But your destiny is not predetermined, and it is up to you to make what you will of that potential, and to decide which direction to take. Hopefully, this planet in sign interpretation will help you to make the right decisions, at the right time, and in the right frame of mind. Beneath your birth chart wheel at the beginning of this report, the positions of the planets in your birth chart are set out by zodiac sign and degree. You will find a key to the zodiac symbols in your interpretation at the end of the report.</Body></Report></XML>
</ResponseData>
<ResponseStatus>
<Code>1</Code>
<Message>OK - Created report</Message>
</ResponseStatus>
</CreateXMLResponse>