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 name	Type	IN	Required	Description
block_id	String	uri	true	The community ID.
status	String	query	false	The status of a specified service ticket.
room_id	String	query	false	The room ID.
apply_user	String	query	false	The applicant.
category_id	Long	query	false	The category ID of a specified service ticket.
service_address	String	query	false	The address of maintenance.
source	Integer	query	false	The 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_time	Long	query	false	The start time of creation.
create_end_time	Long	query	false	The end time of creation.
page_no	Integer	query	true	The page number.
page_size	Integer	query	true	The number of entries to be returned per page.

Return parameter

Parameter name	Type	Description
result	PageResult	The returned result on pages.

Description of result

Parameter name	Type	Description
data	List	The number of entries returned on each page.
total_record	Long	The total number of results.

Description of data

Parameter name	Type	Description
cate_name	String	The category name of a specified service ticket.
parent_category_name	String	The parent category name of a specified service ticket.
p_id	String	The parent category ID of a specified service ticket.
handler	String	The maintenance staff.
handler_id	String	The ID of the maintenance staff.
apply_user	String	The applicant.
operator	String	The operator.
category	String	The operation category.
service_type	String	The service type.
dispatch_content	String	The ticket content.
service_order_id	String	The ID of a specified service ticket.
service_order_no	String	The number of a specified service ticket.
status	String	The status of a specified service ticket.
create_time	Long	The time when a service ticket is created.
has_evaluate	Integer	Indicates whether the service order is reviewed. Valid values: `1`: yes. `0`: no.
service_address	String	The service address.
room_id	String	The room ID.
source	Integer	The source.
user_id	String	The user ID.
block_id	String	The community ID.
creator	String	The ID of the user who creates the service ticket.
desc	String	The description.
expire_start_date	Long	The start time of the reservation.
expire_finish_date	Long	The end time of the reservation.
contacts	String	The contact information.
operator_user	String	The operator.
operator_time	Long	The time of operation.
finish_time	Long	The time of completion.
accept_time	Long	The time of accepting the service ticket.
attachments	List	The image.
source_detail	String	The 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.

Prev DocService Ticket Details

Next DocQuery Community Steward Reviews