Get Service Tickets

Last Updated on : 2023-06-21 07:13:11download

Get a list of service tickets, including the community ID, page number, page size, and other information.

API address

GET: /v1.0/iot-02/community/service-order-page

Request parameter

Parameter nameTypeINRequiredDescription
block_idStringuritrueThe community ID.
statusStringqueryfalseThe status of a specified service ticket.
room_idStringqueryfalseThe room ID.
apply_userStringqueryfalseThe applicant.
category_idLongqueryfalseThe category ID of a specified service ticket.
service_addressStringqueryfalseThe address of maintenance.
sourceIntegerqueryfalseThe source of a specified service ticket. Valid values:
  • 10: Request for maintenance at the front desk.
  • 20: the resident app.
  • 30: the property management app.
  • 40: Request for maintenance by phone.
  • 100: Others.
create_start_timeLongqueryfalseThe start time of creation.
create_end_timeLongqueryfalseThe end time of creation.
page_noIntegerquerytrueThe page number.
page_sizeIntegerquerytrueThe number of entries to be returned per page.

Return parameter

Parameter nameTypeDescription
resultPageResultThe returned result on pages.

Description of result

Parameter nameTypeDescription
dataListThe number of entries returned on each page.
total_recordLongThe total number of results.

Description of data

Parameter nameTypeDescription
cate_nameStringThe category name of a specified service ticket.
parent_category_nameStringThe parent category name of a specified service ticket.
p_idStringThe parent category ID of a specified service ticket.
handlerStringThe maintenance staff.
handler_idStringThe ID of the maintenance staff.
apply_userStringThe applicant.
operatorStringThe operator.
categoryStringThe operation category.
service_typeStringThe service type.
dispatch_contentStringThe ticket content.
service_order_idStringThe ID of a specified service ticket.
service_order_noStringThe number of a specified service ticket.
statusStringThe status of a specified service ticket.
create_timeLongThe time when a service ticket is created.
has_evaluateIntegerIndicates whether the service order is reviewed. Valid values:
  • 1: yes.
  • 0: no.
service_addressStringThe service address.
room_idStringThe room ID.
sourceIntegerThe source.
user_idStringThe user ID.
block_idStringThe community ID.
creatorStringThe ID of the user who creates the service ticket.
descStringThe description.
expire_start_dateLongThe start time of the reservation.
expire_finish_dateLongThe end time of the reservation.
contactsStringThe contact information.
operator_userStringThe operator.
operator_timeLongThe time of operation.
finish_timeLongThe time of completion.
accept_timeLongThe time of accepting the service ticket.
attachmentsListThe image.
source_detailStringThe source of a specified work order. Valid values:
  • 1: app.
  • 2: entered on the page.
  • 3: entered on the WeChat public account.

Request example

GET: /v1.0/iot-02/community/service-order-page

Return example

    "result": {
        "data": [
                "handler": "",
                "parentCategoryName": "Request maintenance of public area",
                "serviceAddress": "Tuya Smart (for R&D self-test) Test 101",
                "operatorUser": "",
                "source": 10,
                "cateName": "Community maintenance",
                "operator": "",
                "applyUser": "Jack",
                "serviceOrderNo": "BX202109260047",
                "createTime": 1632646483666,
                "category": "1399971817937961040",
                "contacts": "",
                "status": "WaitingForDistribute"
        "totalRecord": 1
    "t": 1632647369633,
    "success": true

Error code

For more information, see error code.