提交单个门店匹配/匹配申诉任务
收藏接口说明
- 1、该接口仅支持匹配单门店，接口返回的taskId可作为查询匹配结果的凭证
- 2、该接口会根据传入的商家门店信息匹配抖音门店，如果没有匹配到抖音门店，会自动新建门店
- 3、该接口支持匹配错门店后，对门店匹配结果进行申诉
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/poi/match/task/create/ |
| HTTP Method | POST |
| Scope | life.capacity.poi.basic |
| 权限要求 | poi匹配/申诉 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Body展开全部子属性
account_id必填String
抖音来客账户id
address必填String
详细地址100字以内
city必填String
市（海外和台湾不支持）
ext_id必填String
三方id
latitude必填String
纬度（高德坐标系）
longitude必填String
经度（高德坐标系）
open_status必填Int32
营业状态，1=正常营业,2=新店尚未营业
poi_name必填String
门店名称，50字以内
province必填String
省（海外和台湾不支持）
type_code必填String
门店品类：必须，不允许黑品类、130000地名地址
additional_image_urlsList
补充图片：最多10张，每张分辨率不低于800*800，支持PNG，JPG，JPEG，大小不超过20M
展开子属性
additional_infoString
补充说明：300字以内（申诉时建议传入）
head_image_urlsList
门脸照片：非必须，最多10张，每张分辨率不低于800*800，支持PNG，JPG，JPEG，大小不超过20M
展开子属性
last_task_idString
上次匹配任务id，若传入，则为申诉；若未传入则平台根据三方id查询是否有历史匹配任务id，有则为申诉
open_timesMap
一周中的周几营业 可选值有：1～7（分别对应周一到周日），门店营业时间段：["09:00-18:00", "19:00-23:00"]
展开子属性
tel_listList
营业电话，支持手机/座机号/400800
展开子属性
请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/poi/match/task/create/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"open_times":{"8299378404230511362":["EbUQqO5IAk"]},"type_code":"SGL42UpJeB","ext_id":"Rft35Qbf2t","additional_info":"gQKjS54RCv","latitude":"w3pCV8ua8M","address":"CADmESL4Nw","city":"9ZnKjOOFMx","longitude":"JOliukLKK0","open_status":882296979740040374,"province":"euTU7lXBGN","head_image_urls":["oMufjNYQuX"],"last_task_id":"tFC0GWCBUF","poi_name":"guOPUNqKBS","additional_image_urls":["XYrrtGqlXL"],"tel_list":["mHwSqZUtxA"]}'
响应参数
Body展开全部子属性
err_msg必填String
错误码的错误原因描述（平台标准）
err_no必填Int32
错误码（平台标准）
extra必填Struct
展开子属性
log_id必填String
错误码的错误原因描述（平台标准）
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "err_msg": "qubgJwUeI0", "log_id": "ohgFEkdu3i", "data": { "fail_message": "A5FJd2Sxk9", "task_id": "XQKVHQkTbV", "error_code": 0, "description": "" }, "err_no": 279693633651044260, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "2024112121453827C616769141B25E1405", "now": 1732196739 } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100001 | 未知错误 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙，此时请开发者稍候再试 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 更换参数 |
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制，检查是否有测试环境在同步刷新token |
| 200 | 2119001 | 参数不合法 | 更换参数 |
| 200 | 2119002 | 系统繁忙，请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁，请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权，并在服务商后台同意授权 |
| 200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 4000001 | 根据实际业务错误返回 | 补充参数 |
| 200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 5000001 | 服务器打瞌睡了，请稍后再试。 | |
| 200 | 3000001 | 以实际错误信息为准 |
