# 查看地点

调试诊断

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:getNearbyPoiList

该接口用于查看附近小程序的地点列表。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/wxa/getnearbypoilist?access_token=ACCESS_TOKEN

# 云调用

  • 调用方法:nearbyPoi.getList

  • 出入参和 HTTPS 调用相同,调用方式可查看 云调用 说明文档

# 第三方调用

  • 本接口支持第三方平台代商家调用。

  • 该接口所属的权限集 id 为:37

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填说明
access_tokenstring接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

参数名类型必填说明
pagenumber起始页id(从1开始计数)
page_rowsnumber每页展示个数(最多1000个)

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
dataobject附近小程序的数据

# Res.data Object Payload

附近小程序的数据

参数名类型说明
max_apply_numnumber最大可添加地点个数
left_apply_numnumber剩余可添加地点个数
datastring地址列表的 JSON 格式字符串

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

请求示例

{
  "page": 1,
  "page_rows": 100
}

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "data": {
    "left_apply_num": 9,
    "max_apply_num": 10,
    "data": "{\"poi_list\": [{\"poi_id\": \"123456\",\"qualification_address\": \"广东省广州市海珠区新港中路123号\",\"qualification_num\": \"123456789-1\",\"audit_status\": 3,\"display_status\": 0,\"refuse_reason\": \"\"}]}"
  }
}

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述解决方案
20002POST参数非法
40001invalid credential  access_token isinvalid or not latest获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口
44002empty post dataPOST 的数据包为空
92000该经营资质已添加,请勿重复添加该经营资质已添加,请勿重复添加
92002附近地点添加数量达到上线,无法继续添加附近地点添加数量达到上线,无法继续添加
92003地点已被其它小程序占用地点已被其它小程序占用
92004附近功能被封禁
92005地点正在审核中地点正在审核中
92006地点正在展示小程序
92007地点审核失败
92008小程序未展示在该地点小程序未展示在该地点
93009小程序未上架或不可见小程序未上架或不可见
93010地点不存在地点不存在
93011个人类型小程序不可用个人类型小程序不可用
93012非普通类型小程序(门店小程序、小店小程序等)不可用非普通类型小程序(门店小程序、小店小程序等)不可用
93013从腾讯地图获取地址详细信息失败从腾讯地图获取地址详细信息失败
93014同一资质证件号重复添加

# 7. 适用范围

本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明,均不可调用。