Echo is a simple call that allows you to validate how you are calling the Genability APIs. This is designed for the user who is just beginning to use our APIs as well as for debugging help. For example, you can call the
/validate method to verify the date format you are passing in with your requests is valid. As with all calls, you will need to use a valid App ID and App Key to make these calls.
Echo returns a simple success message when the passed in credentials are valid or an unauthorized response when they are invalid.
Hello returns a “Hello World!” response when the passed in credentials are valid or an unauthorized response when they are invalid.
Errors allow you to simulate receiving a number of possible error messages. This is especially helpful for seeing how your application responds to different error messages as well as quickly learning all the possible errors that may be returned from the APIs.
To simulate an error, pass in the desired error code on the url and the response will be a simulated error condition with that error code.
Here is a full list of the errors and a description of each.
|200||Success – indicates a successful response|
|301||Moved Permanently – indicates the requested resource has been permanently moved|
|400||Bad Request – indicates the request was improperly formatted or missing required parameter|
|403||Not Authorized – indicates the requester is not authorized to access the resource they are requesting|
|404||Not Found – indicates the requested resource was not found|
|500||Server Error – indicates a server error has occurred resulting in the request not being able to be fulfilled|
Authenticate allows you to quickly validate the
appKey you are using. A successful response indicates they are valid.
Validate is a helpful method to make sure the data you are inputting is in a valid and recognized format. This helps a lot with dates and times. Integers and arrays can also be validated.
Along with the required security parameters, the following parameters are sent as part of the request. Only one can be validated at a time. If multiple are sent in, the first one is validated.
|dateTime||String||Validates the passed in string to the ISO 8601 format (e.g. the date and time you want to validate). See the example below for a valid format.|
|integer||Integer||Validates the passed in integer to validate it is recognized as an integer.|
|array||Array||Validates the passed in array to validate it is in a recognized format. Read more about accepted Array Inputs.|
- 3/4/2015 - Format updates
- Validate updates – 10/26/2011
- Initial Release – 7/9/2011 – Echo