Views:

Last Updated: 1/22/2020 12:10:58 AM

Get daily statistics of seat usage within a time range.

1. If a time range is not specified, only the latest seat usage will be returned

2. The maximum time range is 365 days.

3. The response data is sorted in ascending order by the updated date.

Request

HTTP Request

GET /SMPI/{version}/service/wfbss/api/vendors/license

Parameters

Name

Type

Description

Validation

Optional Parameters

     

start_time

integer

Start time of counting interval

Unix timestamp (seconds since 1970-01-01 00:00:00 UTC)

end_time

integer

End time of counting interval

Unix timestamp (seconds since 1970-01-01 00:00:00 UTC)

HTTP Request Example

Get the latest seat usage:
GET /SMPI/{version}/service/wfbss/api/vendors/license

Suppose end_time is set to current timestamp, you can get seat usage from one year ago to the present:
GET /SMPI/{version}/service/wfbss/api/vendors/license?end_time=1370599221

Get daily statistics of seat usage within a time range:
GET /SMPI/{version}/service/wfbss/api/vendors/license?start_time=1369008000&end_time=1370599221

Request Body

Do not supply a request body with this method.

Response

Response

If successful, this method returns an HTTP 200 OK status code and a response body with the following structure:

[
  {
    "seat_in_use": 0,
    "update_time": 1370131200,
    "seat_purchase": 177,
    "vid": "640FE47F-5118-4D79-8221-A35D0DE2EE2C",
    "seat_count_exceed": 0
  },
  {
    "seat_in_use": 4,
    "update_time": 1370217600,
    "seat_purchase": 177,
    "vid": "640FE47F-5118-4D79-8221-A35D0DE2EE2C",
    "seat_count_exceed": 0
  },
  {
    "seat_in_use": 10,
    "update_time": 1370304000,
    "seat_purchase": 177,
    "vid": "640FE47F-5118-4D79-8221-A35D0DE2EE2C",
    "seat_count_exceed": 0
  },
  {
    "seat_in_use": 18,
    "update_time": 1370390400,
    "seat_purchase": 177,
    "vid": "640FE47F-5118-4D79-8221-A35D0DE2EE2C",
    "seat_count_exceed": 0
  }
]

Name

Type

Description

Length

[].seat_in_use

integer

The number of seats in use

[].update_time

integer

Timestamp of when this seat usage updated

Unix timestamp (seconds since 1970-01-01 00:00:00 UTC)

[].seat_purchase

integer

The number of purchased seats

[].vid

string

Vendor ID

GUID

[].seat_count_exceed

integer

Exceeded number of seats