创建任务

post

https://api.myhostex.com/v3/tasks

创建计划任务。该任务可能与房间 (property_id)、特定住宿 (stay_code) 相关联，和/或分配给员工 (staff_id)；全部都是可选的。当提供 stay_code 时，任务将链接到订单；当省略时，property_id 是根据住宿推断的（并且在提供两者时必须与住宿的房间相匹配）。 type 选择任务类别，level 仅对清洁任务有意义。

Body Params

type

string

enum

required

任务类别。

Allowed:

stay_code

string

保留代码以将任务链接到特定订单。提供后，该任务将链接到订单，并且 property_id 默认为住宿的房间（必须匹配显式的 property_id）。

property_id

integer

任务所属房间的 ID。省略记录未分配的任务（或在提供时从 stay_code 继承）。

staff_id

integer

要分配的员工 ID。省略将任务保留为未分配状态。

expected_date

date

required

预期执行日期，格式为 YYYY-MM-DD。按房东账号配置的时区解释（参见账户设置）。

expected_time

string

预计执行时间为 HH:mm:ss。选修的。以房东账号配置的时区进行解释。

level

string

enum

清洁级别。仅当type=cleaning时才有意义。

Allowed:

currency

string

required

货币代码为 fee。有关详细信息，请参阅 Supported Currencies。

fee

number

任务费。默认为 0（如果省略，则为与房间关联的清洁任务的房间配置的清洁费）。

note

string

任务附加自由格式注释（最多 500 个字符）。

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200任务已成功创建。