Search Firmwares

Search firmwares in a tenant.

Request URL

POST {base_url}/uc-cautop/api/v1/firmwares/search-page

Request parameters

Headers
Parameter Required Type Description
Authorization Yes String The access token used for authentication.

Format: Bearer {access_token}.
x-tenant-code Yes String The tenant name.
Note: You can obtain tenant name using the Query Tenants interface.
Body parameters
Parameter Required Type Description
pageNumber Yes Integer The page number to retrieve.
pageSize Yes Integer The number of records to retrieve per page.
keyword No String The keyword used to search for firmwares. The keyword fuzzy matches the firmware version, vendor, model, remark, assigned reseller email, or assigned tenant code.
sorts No Array<Sort_Condition> The sort conditions. If omitted, the result is sorted by creation time in descending order.
Sort_Condition
Parameter Required Type Description
property No String The name of the field to sort by. - vendor - model - firmware_version - remark - updated_at
direction No String The sort order: - asc: Sort in ascending order. - desc: Sort in descending order.

Response parameters

Parameter Type Description
requestId String The unique ID of the request, which can be used to quickly locate the request.
code String The HTTP status code of the request.
  • 200: Request succeeded.
  • Non-200 value: Request failed.
message String The status message of the request.
detailMessage String The detailed error information.

When the request is successful, this parameter returns empty.
result Object<Search_Result> The search result of firmwares.
Search_Result
Parameter Type Description
pageSize Integer The number of records per page.
pageNumber Integer The current page number.
count Integer The total number of firmwares that match the search conditions.
limit Integer The maximum number of firmwares that can be created.
remaining Integer The number of firmwares that can still be created.
results Array<Firmware_Item> The list of matching firmwares.
Firmware_Item
Parameter Type Description
id String The unique identifier of the firmware.
vendor String The vendor identifier of the phone.
model String The model of the phone.
firmwareVersion String The firmware version.
remark String The remark of the firmware.
createdAt String The time when the firmware was created, in Unix timestamp format (seconds).
updatedAt String The time when the firmware was last updated, in Unix timestamp format (seconds).
ownerType String The owner type of the firmware: - admin: Administrator. - reseller: Reseller.
ownerEmail String The email address of the owner's primary account.
ownerDisplay String The display name of the owner, which is assembled according to the role of the current user and the ownership of the resource, for example Admin / user@email.com.
assignedResellers Array<String> The email addresses of the assigned resellers. This parameter is visible to administrators only, and is empty for resellers and tenants.
assignedTenants Array<String> The codes of the assigned tenants. This parameter is visible to administrators and resellers only, and is empty for tenants.

Example

Request example

POST /uc-cautop/api/v1/firmwares/search-page HTTP/1.1
Host: api.cn.novoone.com
Authorization: Bearer eyJraWQiOiJjbi0wLWtleS0xIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJkaXN0cmlidXRvcmV4YW1wbGVAb3V0bG9vay5jb20iLCJncmFudF90eXBlIjoib3BlbmFwaSIsImNsaWVudF9leHQiOnsiZGVzY3JpcHRpb24iOiLnrKzkuInmlrnlkIjkvZzkvJnkvLTlupTnlKgiLCJwYXJ0bmVyIjoi56S65L6L5ZCI5L2c5LyZ5Ly0In0sImNsaWVudF90eXBlIjoib3BlbmFwaSIsImV4cCI6MTc5MDc3MTk2MywiaWF0IjoxNzkwNzUwMzYzLCJqdGkiOiI3MTVhMTMwMC03NzQzLTQ2NzAtYjJjYS1hOWY3ZGM5NjcyYTkiLCJjbGllbnRfaWQiOiJub3ZvLW9wZW4tcGxhdGZvcm0iLCJ1c2VyX2V4dCI6eyJyb2xlSWRzIjpbM10sInN0eXBlIjoiQURNSU4iLCJ0ZW5hbnRDb2RlIjpudWxsLCJ0eXBlIjoiUF9BQ0NPVU5UIiwidXNlcklkIjozMDc2OTEzNjQ0OTE1OTk4NzIwLCJlbWFpbCI6ImRpc3RyaWJ1dG9yZXhhbXBsZUBvdXRsb29rLmNvbSIsInVzZXJuYW1lIjoiZGlzdHJpYnV0b3JleGFtcGxlQG91dGxvb2suY29tIiwidWNJZCI6MzA3NjkxMzY0NDg5MDgzMjg5Nn19.z7HIcw9cCZfV0yaUi2TsRUxLZC-LxJtopsml5vCEyl0-Cs7phmyjrpu0ay0iS0rXvWij0KZSMQmwNTKpqnfhNM3LNaZFTVgJ4-5cN_A5YG827mmCkcpH-n4GPZK8PR8L6iIg-IMpH9GaFxrOEFRjOCMDYpgjz4O3-1xWUNMDI1-1JMxIzG4Vfukt6_-xyOqJ6AYhnNvSjpY_bcRggIk06gsdAXi2JdiyPCYJlEWuYq4MXc3izREPFNZQMQNFuIDD0njyYhkmSTH3oijQ4UYWnUDXWmzTHWejo86UEbhXV-xPJSPwMP1zBhbNx7OU5_1adZ5mM26YffxD9bix5ccUPQ
Content-Type: application/json
x-tenant-code: jint
{
  "pageNumber": 1,
  "pageSize": 5
}

Response example

HTTP/1.1 200 OK
{
  "requestId": "5f9fd56b21cd28c2111f57ffa4c522ae",
  "code": "200",
  "message": "SUCCESS",
  "detailMessage": "",
  "result": {
    "pageSize": 5,
    "pageNumber": 1,
    "count": 0,
    "limit": 10,
    "remaining": 10,
    "results": []
  }
}