查询门店信息

GET

/v1/open/shops/poi

透传调用抖音门店查询接口，不落本地数据库。

只要求调用方传入 poi_id，服务端负责补充 access_token 后转发给抖音，
成功时直接返回抖音原始响应对象。

请求参数

Authorization

API Key

在 header 添加参数

X-Client-Key

示例：

X-Client-Key: ********************

API Key

在 header 添加参数

X-Timestamp

示例：

X-Timestamp: ********************

API Key

在 header 添加参数

X-Nonce

示例：

X-Nonce: ********************

API Key

在 header 添加参数

X-Signature

示例：

X-Signature: ********************

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/v1/open/shops/poi?poi_id' \
--header 'X-Client-Key: <api-key>' \
--header 'X-Timestamp: <api-key>' \
--header 'X-Nonce: <api-key>' \
--header 'X-Signature: <api-key>'

返回响应

🟢200成功

application/json

查询成功，返回抖音原始响应

Body

示例

{
    "data": {
        "poi_id": "7548388352171001882",
        "name": "测试门店"
    },
    "extra": {
        "error_code": 0,
        "description": "success"
    }
}

🟠400请求有误

🟠401未认证

🔴502网关错误

修改于 2026-03-16 02:28:54

获取当前抖音 access_token

查询核销流水