微信开放平台文档（API接口入门（一）：读懂API接口文档）

本文目录

• API接口入门（一）：读懂API接口文档
• iOSAPP端接入微信支付流程
• 微信开放平台 和 微信公众平台 和 商户平台 的区别
• Android不同的app接入微信登陆时，获取的微信openId的是否一样

API接口入门（一）：读懂API接口文档

本文目录：

API接口是什么？

为什么我们需要API接口？

API接口的核心

一、API接口是什么？

我们来以一个常见的数学公式理解API，比如y=x+2，当x=2的时候，y=4，对么？

那此时，我们把y=x+2称为接口，x=2称为参数，y=4称为返回结果，那这个接口的功能就是能把我们输入的数加上2（注意：这里你可以发现接口自身是带有逻辑的）。

类比地，我们来理解一个常见的场景，比如现在有一个可以把经纬度转化为城市的接口，那当我输入经度是55°，纬度是88°的时候，接口通过自己的逻辑运算，返回结果告诉我：杭州市。

这样你就可以清晰地了解百度百科的官方解释了，接口就是预先定义的函数逻辑，他是供其他系统请求，然后返回结果的一个东西。

二、为什么我们需要API接口？

背景：我们的业务系统涉及多方多面，如果要一个公司或者一个系统把所有业务都做完，那未免工作量太大了吧？并且如果其他系统或公司有更好的运算逻辑，那我们在设计功能的时候可以考虑利用接口进行开发。

核心需求：利用现有接口可以降低开发成本，缩短开发成本。

举个例子：比如我是打车的APP，现在我需要在我的页面上展现地图的功能，对于我司而言，新做地图功能未免成本过高，那我们可以在高德开放平台或者百度地图的开放平台，找到地图API，这样的话我们只需要购买高德的服务，部署调用高德地图API，这样就可以快速在我们页面上线地图功能了。

三、API接口的核心

对于小白而言，初看API文档可能是一头雾水的——从哪里看，怎么看，看什么是摆在面前的问题。

其实对于产品经理而言，我们应该更关注这个公司可以提供什么样的API接口服务，比如我知道高德可以提供地图API，规划路线的API，这样的话在我们设计功能和工作中就可以想到调用他们的服务或者参考。

所以产品小白们看不懂也不用过于担心，未来工作中你也会更深入了解清楚，因为看懂并不复杂，以下是API接口的核心点，所有的说明文档离不开这5个核心点。

以下说明均以微信开放平台为例说明，文末有各开放平台的地址，大家有空可以去学习。好了，事不宜迟，现在我们来建立一个场景。

我们现在有一个APP，需要用户在购买的时候调起微信支付的API，完成购买。请各位自动进入这个场景，把自己当作一位产品经理。

1. 接口地址

现在Now，用户点击付款，我们需要告诉微信，我们要调起你们的收银台啦！但，去哪里告诉呢？这就需要接口地址了，也就相当于向微信的这条链接传输指定的数据。

一个链接地址不是我们理解的一个页面，你可以理解是一个电话号码，小白们要改变这个观念。

此时我们可以看到接口文档告诉我们链接是如下这条，那我们现在已经拨通微信的电话了。

2. 请求参数（报文）

我们现在需要告诉微信，你想调用收银台对吧。那我们需要写下来，此时生成的叫做报文，也就是你想告诉这个接口的内容是什么？相当于前文函数的输入x=2。

一般来说，报文的格式和内容都是按接口文档规定的。如下文就是微信开放平台对调起收银台的报文要求。

我们先来看前2个参数，你现在跟微信在对话，是不是应该先告诉微信，你是谁？这里微信的文档告诉你应该要用应用ID+商户号来确定你的身份，什么意思呢？

比如你是A商户，下面有a，b，c三个APP，所以微信要知道你是哪个商家，下面的哪个APP要用收银台。这是非常重要的，微信后面要把收到的钱打到对应的账户以及统计数据等。

那我们就在报文里面写下这两句话：

《appid》wx2421b1c4370ec43b《/appid》（我的应用ID是wx2421…….）

《mch_id》10000100《/mch_id》（我的商户号是10000…….）

好了，现在微信知道你是谁了，那你要告诉微信，你需要微信支付帮你收多少钱对吧？这里定义了货币类型和总金额，也就是收什么货币，收多少钱。

这里你看，货币类型的必填写了否，也就是说你也可以不告诉微信支付货币类型是什么，因为他在后面备注了默认是人民币。

好的，那我们写下两段报文

《free_type》CNY《/ free_type 》（我要收人民币）

《total_fee》1《/tota

可供参考的开放平台网站

微信支付： 高德平台开放平台：https://lbs.amap.com/

iOSAPP端接入微信支付流程

商户在微信开放平台申请开发APP应用后，微信开放平台会生成APP的唯一标识APPID。在Xcode中打开项目，设置项目属性中的URL Schemes为您的APPID。如图所示。
2.导入微信支付SDK
将官方demo中的这个文件夹拷贝到项目里

在APPdelegate里设置APPID
导入依赖库
项目中点击支付的按钮写上如下方法

别忘了导入头文件和遵循代理和注册代理  
info.plist里添加如下字段LSApplicationQueriesSchemes，为Array类型，然后在里面添加两个小选项，分别为weixin和wechat
注意！！！下面这三处  一定要对应上  少一不可
如果不回调，APPdelegate里写上这个

//被废弃的方法如下

- (BOOL)application:(UIApplication*)application handleOpenURL:(NSURL*)url {

    return  ;

}

- (BOOL)application:(UIApplication*)application openURL:(NSURL*)url sourceApplication:(NSString*)sourceApplication annotation:(id)annotation {

    return ;

}

//替换的新方法

- (BOOL)application:(UIApplication*)app openURL:(NSURL*)url options:(NSDictionary*)options {

    return ;

}
//调起微信支付

    PayReq* req  = ;

    req.partnerId = @"1220277201";

    req.prepayId  = @"9201039000160315ab9324b87b451223";

    req.nonceStr  = @"83DB7tk21akNRSFs";

    req.timeStamp = 1458027344;

    req.package  = @"Sign=WXPay";

    req.sign      = @"db6919dbd8ccb3f8a25108bebcd87f7a02c52e39";

    ;
// 获取当前时间

    time_t now;

    time(&now);
    // 时间戳

    //NSString *timestamp = ;
    // 随机字符串

    //NSString *nonceStr = ;
    //订单id

    NSString *prepayid =  _prepayid;
    PayReq *request = ;

    /** 商家向财付通申请的商家id */

    request.partnerId = WXPartnerid;

    /** 预支付订单 */

    request.prepayId= prepayid;

    /** 商家根据财付通文档填写的数据和签名 */

    request.package = @"Sign=WXPay";

    /** 随机串，防重发 */

    request.nonceStr= _noncestr;

    /** 时间戳，防重发 */

    request.timeStamp = ;

    /** 商家根据微信开放平台文档对数据做的签名 */

    request.sign= _sign;

    /*! @brief 发送请求到微信，等待微信返回onResp

     *

     * 函数调用后，会切换到微信的界面。第三方应用程序等待微信返回onResp。微信在异步处理完成后一定会调用onResp。支持以下类型

     * SendAuthReq、SendMessageToWXReq、PayReq等。

     * @param req 具体的发送请求，在调用函数后，请自己释放。

     * @return 成功返回YES，失败返回NO。

     */

    ;

微信开放平台 和 微信公众平台 和 商户平台 的区别

微信开放平台 和 微信公众平台 和 商户平台 的区别

一.微信开放平台:主要面对移动应用/网站应用开发者，为其提供微信登录、分享、支付等相关权限和服务,微信开放平台还提供了数据统计功能，用于开发者统计接入应用的登录、分享等数据情况,以京东APP举例，比如京东APP需要使用微信登录、分享和微信支付功能，首先注册微信开发平台-开发者账号，并按照以下流程在微信开放平台创建京东APP，审核通过后，即可获得以下的初级权限，如要获得更高如微信支付权限，需要再单独申请，具体微信支付权限申请步骤详见附件《移动应用-微信支付权限申请流程》。

（1） 基础运营功能：公众号申请成功后即可获得群发功能、自动回复、自定义菜单、投票管理。

（2） 高级功能：微信公众平台还提供了以下高级的功能来丰富公众号，以下权限需要二次开发。

（3） 微信支付：提供公众号内微信支付能力，和移动应用一样也需要单独申请，流程和移动APP流程类似。

（4）管理：包括已关注用户管理、消息管理、素材管理。

（5）推广：包括广告主（定向投放广告，精准推广自己的服务）和流量主（按月获取广告收入）。

（6）统计：用户分析、图文分析、消息分析、接口分析（自定义菜单调用量）。

无论是申请公众平台商户,还是开放平台商户，申请成功后，都会拥有商户平台账号，可登陆商户平台进行操作,商户平台主要就是做微信支付用的，如果APP或者公众号需要接入支付功能，那么就需要在公众平台申请公众平台商户，或者在开放平台申请开放平台商户,申请成功后会分配商户平台账号。

微信开放平台，是可以设置一些东西的 不如app上的微信登录
商户平台，是管理微信公众平台支付接口收入的
微信公众号，是对位推广吸粉的

开发平台是供开发者开发程序和发布的。公众平台是发文章的，商户平台是微信支付的平台

微信公众平台和微信开放平台的区别

微信公众平台是新媒体发布，开放平台是做微信平台的二次开发。一个的服务对象是大众，另一个的服务对象是微信公众平台。

公众平台更偏重基础使用，开放平台更偏重应用和开发。
开放平台分析功能要比公众平台强大，进入门槛高，至少目前不是所有人都能申请。

你可以这样理解：公众平台是普通用户可以看（没、修改、发布之类的后台操作权限），但只有指定用户（公众号）可以、更新等操作；开放平台是只要申请通过就都可以使用

微信公众平台用于申请以及管理微信公众号，而微信开放平台用于给应用开发者在自己开发应用中接入微信的功能，如微信登录，微信支付等等，在这个平台上可以申请一个开发者账号，并通过开放平台的开发文档将微信对应的功能接入到自己的应用中去

公众平台是管理公众号的，开放平台有三个功能，分别是实现通过开发使你的网站通过微信登陆，通过开发使你的app可以通过微信登陆，开发第三方公众号管理平台

Android不同的app接入微信登陆时，获取的微信openId的是否一样

Android不同的app接入微信登陆时，获取的微信openId的不一样。

为了识别用户，每个用户针对每个公众号会产生一个安全的OpenID，如果需要在多公众号、移动应用之间做用户共通，则需将这些公众号和应用绑定到一个开放平台账号下，绑定后，一个用户虽然对多个公众号和应用有多个不同的OpenID，但他对所有这些同一开放平台账号下的公众号和应用，只有一个UnionID。

扩展资料

微信平台开发者注意事项：

1、微信公众平台开发是指为微信公众号进行业务开发，为移动应用、PC端网站、公众号第三方平台（为各行各业公众号运营者提供服务）的开发，请前往微信开放平台接入。

2、在申请到认证公众号之前，你可以先通过测试号申请系统，快速申请一个接口测试号，立即开始接口测试开发。 3、在开发过程中，可以使用接口调试工具来在线调试某些接口。

4、每个接口都有每日接口调用频次限制，可以在公众平台官网-开发者中心处查看具体频次。 5、在开发出现问题时，可以通过接口调用的返回码，以及报警排查指引（在公众平台官网-开发者中心处可以设置接口报警），来发现和解决问题。

6、公众平台以access_token为接口调用凭据，来调用接口，所有接口的调用需要先获取access_token，access_token在2小时内有效，过期需要重新获取，但1天内获取次数有限，开发者需自行存储，详见获取接口调用凭据（access_token）文档。

7、公众平台接口调用仅支持80端口。