提交门店匹配任务

开发环境

http://dev-cn.your-api-server.com

POST

/poi/v2/supplier/match/

权限申请
POI货架展示屏蔽申请

将三方门店与抖音门店建立匹配关系。建立匹配关系后，开发者可通过三方系统内的唯一 id 管理商家已完成认领或建立关联关系的抖音门店 id 进行管理。

使用限制

无

接口说明

业务场景：

通过门店匹配，将客户系统的三方id和抖音门店ID完成映射，建立匹配关系；方便客户通过自身系统的id进行抖音生活服务业务的门店管理操作；

注意事项：

门店坐标经纬度信息需使用 GCJ-02 坐标系坐标，否则门店定位会有较大偏差。

此接口为异步接口，需查询“查询门店匹配任务结果”接口进行获取任务结果。

当门店已经完成匹配或者正在匹配中时，请不要重复提交匹配；匹配失败后，可再次发起匹配。

可通过“查询门店匹配状态”获取门店匹配任务 ID 和匹配状态信息。

匹配成功并不意味着匹配正确，需要自行核对匹配结果中的抖音门店是否为期望门店，若匹配错误，可在线咨询进行解绑。

咨询问题时，请提供请求响应返回的taskID。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/poi/v2/supplier/match/' \
--header 'access-token: clt.c4944e91479f53a75c554c0575bedbf9N6Nm5pkdYJFE7io9borLftK2GSag' \
--header 'Content-Type: application/json' \
--data-raw '{
    "match_data_list": [
        {
            "supplier_ext_id": "123451",
            "poi_id": "7237783383823091746",
            "poi_name": "测试POI",
            "province": "新疆维吾尔自治区",
            "city": "阿克苏地区",
            "address": "庐山路华晨大拇指商业广场5楼",
            "latitude": 82.580195,
            "longitude": 40.101612,
            "extra": ""
        }
    ]
    
}'

响应示例

200 - 成功示例

{
  "data": {
    "description": "",
    "error_code": 0,
    "is_success": 1,
    "task_id": "7252956489000830988"
  },
  "extra": {
    "logid": "202307091902332F876B33B5C955E91BA7",
    "now": 1688900554166
  }
}

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

access-token

string

必需

接口调用凭证
示例值："clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ"
了解更多：access_token获取方式

示例值:

clt.c4944e91479f53a75c554c0575bedbf9N6Nm5pkdYJFE7io9borLftK2GSag

Body 参数application/json

match_data_list

array [object {9}]

必需

用于匹配抖音门店的三方系统内的唯一信息列表，建议 <= 1000

supplier_ext_id

string

可选

三方系统内的唯一 id

poi_id

string

可选

抖音门店 id （若已获取抖音门店 id，可直接用于关联匹配，以提高匹配成功率）

poi_name

string

门店名称

可选

province

string

省份名称

可选

city

string

可选

城市名称（可为空字符串，仅供问题排查使用）

address

string

门店地址信息

可选

latitude

number

可选

纬度，精度为小数点后6位，需使用 GCJ-02 坐标系统

longitude

number

可选

经度，精度为小数点后6位，需使用 GCJ-02 坐标系统

extra

string

可选

其他信息，可为空字符串

示例

返回响应

🟢200成功

application/json

Body

data

object

必需

description

string

错误描述

必需

error_code

integer

必需

错误码，非 0 表示失败

is_success

integer

必需

任务提交状态 1 - 成功 2 - 失败

task_id

string

必需

匹配任务 id，咨询问题时需提供

extra

object

必需

logid

string

必需

抖音侧日志 id，咨询问题时需提供

now

integer

必需

请求响应时间，秒级时间戳

🟠400请求有误

店铺匹配状态查询

查询全部店铺信息接口(天级别请求5次)

提交门店匹配任务

使用限制#

接口说明#

请求参数

返回响应

使用限制

接口说明