Endpoint: endpoints
Endpoint
Description
This endpoint is written to eventually be used in the API Browser. The goal is to automate the API testing and the view showing what API calls that is available.
Syntax
By just calling this endpoint, will render a permission error:
Without permissions
{ "response": [], "errors": { "code": "403", "success": "", "faultstring": "Unauthorized: Administrative account required" } }
However, with permissions, you will get a bit rendered respose object back. LIke this:
Endpoints response
{ "endpointsResponse": { "enabledEndpoints": [ "urltest", "dnsbl", "test", "application" ], "disabledEndpoints": [], "describedEndpoints": { "urltest": "URL Testing Endpoint (Availability)", "dnsbl": "Tornevall Networks DNSBL API", "test": "Standard API tester", "application": "Application handler" }, "endpointStates": [], "endPointsVerifyEntry": [] } }
This function call displays the available endpoints for APIv3. But what if you want to use an endpoint? How do we check up the available syntaxes?
Making a call to /3.0/endpoints/getEndpointMethods/endpoint/theEndPointName will reveal a bit more about the specific endpoint. In this example, we use the endpoint urltest:
endPointMethodsResponse
{ "getEndPointMethodsResponse": [{ "methods": [ "isAvailable" ], "descriptions": { "isAvailable": "Check availability for an URL" }, "behaviours": { "isAvailable": { "return": "array" } }, "variables": [] }] }
In the urltest-endpoint, one http request method is usable: isAvailable. So our API will return three objects for you:
Object | What it tells you |
---|---|
methods | An array with available methods |
description | A short description of what each method do when it is called |
behaviours | A list with the returned responses gives you (this might differ a bit with the reality) |