微信小程序教程
7.12.17 附近
阅读(

微信小程序介绍

微信小程序设计指南

微信小程序开发简介

微信小程序开发框架

微信小程序框架视图层

微信小程序框架组件

微信小程序框架 API

概述

网络

媒体

操作文件

本地存储

位置

设备

界面

Canvas绘图

WXML节点信息

第三方平台

开放接口

生物认证

获取发票抬头

打开小程序

微信运动

设置

卡券

收货地址

获取二维码

转发

客服消息

模板信息

微信支付

授权

用户信息

授权

登录

附近

附近的小程序API,提供给需快速批量创建附近地点的小程序开发者使用,使用前请先调高附近地点额度。

调高附近地点额度申请方式如下:

下载《调高地点额度申请表》,填写后发送至 placeofminiprogram@qq.com。

邮件主题为:“帐号名称”申请调高附近地点额度。审核通过后可调高额度。

添加地点

接口地址:

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

请求方式: POST(请使用https协议)

获取 access_token 详见文档

1. 请求参数说明:
参数 说明 备注
related_name 经营资质主体 经营资质主体与小程序同主体--不填;
经营资质主体与小程序非同主体--必填;
related_credential 经营资质证件号 必填
related_address 经营资质地址 必填
related_proof_material 相关证明材料照片临时素材mediaid 经营资质主体与小程序同主体--不填;
经营资质主体与小程序非同主体--必填;

注:related_proof_material通过临时素材上传接口上传,接口地址:

https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

临时素材[接口文档](https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738726)

POST数据示例:

{

"related_name":"XXX公司",

"related_credential":"12345678-0",

"related_address":"广州市新港中路397号TIT创意园",

"related_proof_material":"3LaLzqiTrQcD20DlX_o-OV1-nlYMu7sdVAL7SV2PrxVyjZFZZmB3O6LPGaYXlZWq"

}
2. 返回json示例:

返回参数说明:

参数 说明 备注
audit_id 审核单ID 必填
poi_id 附近地点ID 必填
related_credential 经营资质证件号 必填

返回内容示例:

{
  "errcode":0,
  "errmsg":"ok",
  "data":{
    "audit_id":416620525
  }
}
3. 错误码说明:
返回码 说明
47001 POST数据json格式错误
20002 POST参数非法
44002 POST数据为空
92000 该经营资质已添加,请勿重复添加
92002 附近地点添加数量达到上线,无法继续添加
92004 附近功能被封禁
93011 个人类型小程序不可用
4. 事件推送
<xml>
  <ToUserName><![CDATA[gh_4346ac1514d8]]></ToUserName>
  <FromUserName><![CDATA[od1P50M-fNQI5Gcq-trm4a7apsU8]]></FromUserName>
  <CreateTime>1488856741</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[add_nearby_poi_audit_info]]></Event>
  <audit_id>11111</audit_id>
  <status>3</status>
  <reason><![CDATA[xxx]]></reason>
  <poi_id>111111</poi_id>
</xml>

参数说明

参数 说明
audit_id 审核单id
status 审核状态(3:审核通过,2:审核失败)
reason 如果status为3或者4,会返回审核失败的原因
poi_id poi_id

查看地点列表

接口地址

https://api.weixin.qq.com/wxa/getnearbypoilist&page=1&page_rows=20?access_token=ACCESS_TOKEN

请求方式: GET(请使用https协议)

1. 请求参数说明:
参数 说明 备注
page 起始页id(从1开始计数) 必填
page_rows 每页展示个数(最多1000个) 必填

返回参数说明:

参数 说明 备注
data.left_apply_num 剩余可添加地点个数
data.max_apply_num 最大可添加地点个数
data.data 地址列表的json格式字符串
data.data.poi_list[i].poi_id poi_id
data.data.poi_list[i].qualification_address 资质证件地址
data.data.poi_list[i].qualification_num 资质证件证件号
data.data.poi_list[i].audit_status 地点审核状态(3:审核中,4:审核失败,5:审核通过)
data.data.poi_list[i].display_status 地点展示在附近状态(0:未展示,1:展示中)
data.data.poi_list[i].refuse_reason 审核失败原因 audit_status=4时返回
2. 返回json示例:
{
  "errcode":0,
  "errmsg":"",
  "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":""
            }
         ]
     }"
  }
}
3. 错误码说明:
返回码 说明
-1 系统错误

删除地点

接口地址

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

请求方式: POST(请使用https协议)

1. 请求参数说明:
参数 说明 备注
poi_id 附近地点ID 必填

POST数据示例:

{
  "poi_id":"469382092"
}
2. 返回json示例:
{
  "errcode":92005,
  "errmsg":"地点正在审核中"
}
3. 错误码说明:
返回码 说明
92004 近功能被封禁
92005 地点正在审核中
92006 地点正在展示小程序
93010 地点不存在
93011 个人类型小程序不可用

展示/取消展示附近小程序

接口地址

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

请求方式: POST(请使用https协议)

1. 请求参数说明
参数 说明 备注
poi_id 附近地点ID 必填
status 0:取消展示;1:展示 必填

POST数据示例:

{
  "poi_id":"469487775",
  "status":0
}
2. 返回json示例:
{
  "errcode":92008,
  "errmsg":"小程序未展示在该地点"
}
3. 错误码说明:
返回码 说明
92003 地点已被其它小程序占用
92004 附近功能被封禁
92005 地点正在审核中
92007 地点审核失败
92008 程序未展示在该地点
93009 小程序未上架或不可见
93010 地点不存在
93011 个人类型小程序不可用

如果本教程对您帮助很大,请随意打赏。您的支持,将鼓励我们提供更好的教程!

← 键盘方向键翻页 →
返回顶部 手机访问 关注微信 返回底部

扫码访问歪脖网

随时随地,想看就看

关注歪脖网微信

分享 web 知识、交流 web 经验