查询门店任务结果__抖音开放平台

用于品牌同步、门店同步、门店亮照、门店信息更新、门店装修等异步任务结果查询。

使用限制

请先提交任务后再进行查询。

接口说明

HTTP URL	https://open.douyin.com/goodlife/v1/poi/task/query/
HTTP Method	GET
权限要求	门店任务查询
Scope	life.capacity.poi.task.query
权限申请	•申请权限，路径：抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案 •商家授权，路径：抖音来客>店铺管理>第三方应用授权

请求头

名称	类型	是否必填	描述
Content-Type	string	是	固定值："application/json"
access-token	string	是	接口调用凭证示例值："clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ" 了解更多：access_token获取方式

请求参数

Query

名称	类型	是否必填	描述	示例值
task_ids	string	是	门店任务 id，多个使用,分隔	7252172270860109858,7252172574120036390

请求示例

Plain Text复制
curl --location 'https://open.douyin.com/goodlife/v1/poi/task/query/?task_ids=7252172270860109858%2C7252172574120036390' \
--header 'Content-Type: application/json' \
--header 'access-token: clt.2fe065a0538aa8f4d96291fc74c02e3bLZTUFTt671bn5N7vcAXf81BtIwmr' \

响应参数

名称					类型	描述
data					struct
	task_results				struct[]	任务结果信息
		task_id			int	门店任务 id
		third_id			string	三方门店 id
		poi_id			string	抖音门店 id
		business_partnership_result			struct	商服绑定关系的结果。（服务商同步品牌 / 门店后，会进行商服关系绑定，若同步失败，则无此字段信息）
			partnership_id		int	合作关系 id
			status		int	任务执行状态 1 - 待执行 2 - 执行中 50 - 执行成功 60 - 执行失败
			reject_reason		string	拒绝原因商服同步失败原因（亦可参考同步门店账户接口的字段说明）： •满足任一条件，则无法建联 ◦该商家已经在抖来客app上与服务商建联（平台代运营，非小程序代运营） ◦该商家已经与其他服务商建联(如果是迁移商家，则可以豁免) ◦该商家已经签约了群峰订单 ◦该商家的母账户（品牌户）已经签约了平台代运营 ◦服务结束时间晚于当前时间（说明合作已经结束）
		trademark_result			struct	品牌审核结果（若是同步品牌户，有此字段）
			account_id		string	品牌户商户 id
			status		int	任务执行状态 1 - 待执行 2 - 执行中 50 - 执行成功 60 - 执行失败
			reject_reason		string	拒绝原因
		claim_result			struct	门店同步、门店资质亮照/修改任务审核结果（若同步门店或门店资质亮照/修改，有此字段）
			account_id		string	门店户商户 id
			status		int	任务执行状态 1 - 待执行 2 - 执行中 50 - 执行成功 60 - 执行失败
			reject_reason		string	拒绝原因
		poi_result			struct	门店基础信息更新任务结果（若门店基础信息更新，则有此字段）
			reject_reason		string	整体拒绝原因
			key_audit_result_list		struct[]	各字段审核结果
				key	string	字段
				status	int	任务执行状态 1 - 待执行 2 - 执行中 50 - 执行成功 60 - 执行失败
				reject_reason	string	拒绝原因
		poi_decoration_result			struct	门店装修任务结果（若门店装修，则有此字段）
			reject_reason		string	整体拒绝原因
			key_audit_result_list		struct[]	各个字段审核结果
				key	string	字段
				status	int	任务执行状态 1 - 待执行 2 - 执行中 50 - 执行成功 60 - 执行失败
				reject_reason	string	拒绝原因
	error_code				int	错误码，成功为 0
	description				string	错误信息
extra
	error_code				int	错误码，非 0 表示失败
	description				string	错误描述
	sub_error_code				int	子错误码，成功返回 0，此接口暂未使用
	sub_description				string	子错误描述，此接口暂未使用
	logid				string	抖音侧日志 id，咨询问题时需提供
	now				int	请求响应时间，秒级时间戳

响应示例

正常示例

JSON复制
{
    "data": {
        "task_id": 7248591123814352935,
        "error_code": 0,
        "description": "success"
    },
    "extra": {
        "error_code": 0,
        "description": "success",
        "sub_error_code": 0,
        "sub_description": "",
        "logid": "202306261420441A17A89D364C3F21B86B",
        "now": 1687760445
    }
}

异常示例

JSON复制
{
    "data": {
        "error_code": 2100005,
        "description": "参数不合法"
    },
    "extra": {
        "error_code": 2100005,
        "description": "参数不合法",
        "sub_error_code": 0,
        "sub_description": "ext_id should be string",
        "logid": "20230704154135EAE35281703E3713D80C",
        "now": 1688456495773
    }
}

查询门店任务结果

​使用限制​

​接口说明​

​请求头​

​请求参数​

​Query​

​请求示例​

​响应参数​

​响应示例​

​正常示例​

​异常示例​

使用限制

接口说明

请求头

请求参数

Query

请求示例

响应参数

响应示例

正常示例

异常示例