OS

OS

Access to operating systems is provided to all users who have the appropriate permission in their personal account.
For getting information about operating systems, the following requests are provided:

The list method allows you to get a list of the operating systems

Request:

{site_path}/{lang}/api/os/list

GET parameters list:

filter array Allows filtering data by all available fields
fields string Allows to select only the specified fields from all available
sort string Allows you to sort asc and desc entities by all available fields
page int Allows you to pass the page number of the list of entities

List of all available fields

id int ID of the operating system
name string Operating system name
groupID int Operating system group's ID
isDesktop boolean If it is desktop system
Values:
  • 1 - yes
  • 0 - no
isMobile boolean If it is mobile system
Values:
  • 1 - yes
  • 0 - no
active boolean Operating system status
Values:
  • 1 - enabled
  • 0 - disabled

Response

The response is transmitted in JSON format. List of response fields:

result array List of operating systems based on query parameters
_links array List of navigation links. May contain the following elements:
  • self - contains a link to the current page of the list
  • first - contains a link to the first page of the list
  • last - contains a link to the last page of the list
  • prev - contains a link to the previous page of the list
  • next - contains a link to the next page of the list
_meta array Information on list navigation. Contains elements:
  • totalCount - total number of available entities considering all selected parameters
  • pageCount - the sequence number of the entity in the list that starts the current page
  • currentPage - number of the current page
  • perPage - number of entities displayed on one page

Request example:

{site_path}/{lang}/api/os/list?filter[id][in][]=1&filter[id][in][]=2&filter[id][in][]=3&sort=name

Response example:

{
  "result": [
    {
      "id": 3,
      "name": "Windows 7",
      "groupID": 1,
      "isDesktop": "1",
      "isMobile": "0",
      "active": "1"
    },
    {
      "id": 2,
      "name": "Windows xp",
      "groupID": 1,
      "isDesktop": "1",
      "isMobile": "0",
      "active": "1"
    }
  ],
  "_links": {
    "self": {
      "href": "{site_path}/{lang}/api/os/list?%3Ffilter%5Bid%5D%5Bin%5D%5B0%5D=1&filter%5Bid%5D%5Bin%5D%5B0%5D=2&filter%5Bid%5D%5Bin%5D%5B1%5D=3&sort=name&page=1"
    }
  },
  "_meta": {
    "totalCount": 2,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 20
  }
}