Comment on page
REST API
Overview
All URLs referenced in the documentation have the following base:
Standard platform | High availability platform |
---|---|
https://sd.iadvize.com/api/2 | https://ha.iadvize.com/api/2 |
The iAdvize REST API is served over HTTPS.
The API key must be attached to each request. You can use it in one of the following ways:
- Passed in as a
X-API-Key
HTTP header - Passed in as a
key
GET parameter - Passed in as the username (with an arbitrary password) via
HTTP Basic authentication
{
meta: {
status: "error",
message: "Forbidden"
}
}
GET /my_resource
{
meta: {
status: "success"
},
data: [
{
id: 789,
_link: "/my_resource/789"
},
{
id: 456,
_link: "/my_resource/456"
},
{
id: 123,
_link: "/my_resource/123"
}
],
pagination: {
page: 1,
pages: 1,
limit: 20,
count: 3
}
}
Filter | Description | Values |
---|---|---|
page | Page number | ?page=1 |
limit | Maximum number of resources per page (maximum possible value is 100) | ?limit=1 |
full | Show all fields of the resource | ?full=1 |
Use the
*
character to broaden the scope of your search. E.g.: filters[name]=*uli*
GET /my_resource/123
{
meta: {
status: "success"
},
data: {
id: 123,
my_field: "my_value",
_link: "/my_resource/123"
}
}
GET /my_resource/456
(with error){
meta: {
status: "fail",
message: "Unknown 'my_resource' with 'id' 456."
}
}
Last modified 1mo ago