华邦科技官方网站

1、登录服务商后台：http://huabangruanjian.com

资质审核需要1个工作日，资质审核通过后，即可进入应用创建流程获取client_id；

按照对应的应用类目进行缴纳：

支付完成后即可进入应用创建、编辑页面:

应用创建完成，显示在应用列表，显示“待审核”状态，应用审核需一个工作日；

按照页面提示，点击进入“请缴纳您的诚信保证金”，进入缴纳保证金页面，流程同上面的2.1一样。

华邦科技服务商在后台创建应用并审核通过后，需要对应用进行授权开发，授权开发成功后再可以发布服务上线到服务市场展示，应用开发具体流程如下:

如果您的应用和HuaBang云对接时需要获取用户隐私数据(如商品、订单等)，为保证用户数据的安全与隐私，您的应用需要取得用户的授权，即获取访问用户数据的授权令牌 Access Token。这种情况下，您的应用需要引导用户完成使用华邦科技帐号“登录授权”的流程。华邦科技OAuth2.0流程采用国际通用的OAuth2.0标准协议作为用户身份验证与授权协议，支持网站、手机客户端、桌面客户端。

1、client_id 和 client_secret 是开发者的应用发起华邦科技和Oauth 授权的凭证；

一个应用必须申请一份对应的 client_id 和 client_secret，才能发起 Oauth 授权请求；一个服务商可以有多个应用；

2、redirect_uri指的是应用发起请求时，所传的回调地址参数，在用户授权后应用会跳转至redirect_uri；

3、access_token即服务商授权后颁发的调用华邦科技API 的凭证；

4、RefreshToken即刷新access_token的凭证，当access_token过期时，服务商可以用RefreshToken刷新得到新的access_token。

1 登录华邦服务商中心，选择你所需要授权的应用。点击“配置”设置应用跳转地址。

注意：跳转地址填写的是接入方自己的一个有效的url，用于接收开放平台返回的code和state参数。请确保“回调地址（redirect_uri）”与“创建应用”时填写的地址保持一致。

2 点击“API权限”查看CLIENT_ID和CLIENT_SECRET，建议复制在TXT文档中，便于后续拼接请求地址时使用。

注意：标红部分为需要你修改的参数（填写时去掉大括号），若无state可不用填写。

@client_id：在创建完应用即可获得。

@redirect_uri：回调地址，是在你选择好需要授权的公众号后，跳转的地址，请确保你能在该地址进行数据获取操作。实际进行授权操作时，测试的数据 client__id、redirect_uri均需要根据自己创建的应用实际数据给予替换，不能拿示例中给出的值直接进行测试，以免影响实际测试效果。

说明：可发布服务市场的服务，在服务上线后，如购买服务的用户，通过"我的服务--立即使用”访问(下图)，系统会自动跳到授权页面(因此这种方式访问应用的，不需要拼接url)，只需注意获取code即可

另返回code时，还会返回通过state传递订购服务相关的信息，类似如下：

state=sign:C54E2894C1401455A648547EA4DBC5E4;endTime:xxx;versionName:xxx

sign:state完整签名，以client_secret为签名密钥，MD5加密

endTime: 服务结束时间

versionName: 版本名称

sign = md5(client_secret+endTime+versionName)

请求方式：POST

注意：标红部分为需要你修改的参数（填写时去掉大括号）。

@code 在上一步骤获取

@client_id 即成功创建应用时生成的ClientID

@client_secret 即成功创建应用时生成的ClientSecret

@redirect_uri 回调地址，是在你选择好需要授权的公众号后跳转的地址，请确保你能在该地址进行数据获取操作。实际进行授权操作时，测试的数据 client_id、client_secret、redirect_uri均需要根据自己创建的应用实际数据给予替换，不能拿示例中给出的值直接进行测试，以免影响实际测试效果。

请求方式：POST

{client_secret}&refresh_token={refresh_token}

1、服务市场授权入口，默认的refresh-token时长为商户所购买服务的有效时长。

2、自定义授权入口，refresh_token的默认有效时长为7天，在refresh_token未失效时间内，可使用refresh_token刷新access_token，则会对refresh_token的有效期增加2个小时，但refresh_token有效期最终上限7天保持不变。也就是说只要持续刷新，这个refresh-token一直是有效的。

PS:目前该api只返回商户的pid,name,avatarUrl三个字段的信息。

请求方式GET

online：http://dopen.huabon.net/api/1_0/open/usercenter/gethuabonUserInfo?accesstoken={accesstoken}

{
"data": {"pid": "55628727","name": "华邦科技开放服务平台","avatarUrl": "http://wx.qlogo.cn/mmopen/scAWiciaAIqhVtHQmXZmWBLbA08DEoHib20x5vHF818tG5zEf8BU6dGELnjibibdYeic1YlqlCdFP9dHVF8ibgTRdwjohEZWfJKB6zU/0 },"code": {"errcode": 0,"errmsg": "success"}}

6、服务审核需要3个工作日，注意服务待审核状态详情不可进行编辑，审核前和审核后都可对服务详情进行编辑修改，修改详情信息需要再次审核；

若商户所需要的服务已在华邦科技服务市场上架，购买后可通过“我的服务”——“立即使用”访问(下图)，系统会自动跳到授权页面(因此这种方式访问应用的，不需要拼接url)，只需注意获取code即可。

另返回code时，还会返回通过state传递订购服务相关的信息，类似如下：

state=sign:C54E2894C1401455A648547EA4DBC5E4;endTime:xxx;versionName:xxx

sign:state完整签名，以client_secret为签名密钥，MD5加密

endTime: 服务结束时间

versionName: 版本名称

sign = md5(client_secret+endTime+versionName)

请求方式：GET

请求地址http://dopen.huabon.net/api/1_0/open/usercenter/gethuabonUserInfo?accesstoken={accesstoken}

返回数据结构：

{

"data": {

"pid": "55628727",

"name": "华邦开放服务平台",

"avatarUrl": "http://wx.qlogo.cn/mmopen/scAWiciaAIqhVtHQmXZmWBLbA08DEoHib20x5vHF818tG5zEf8BU6dGELnjibibdYeic1YlqlCdFP9dHVF8ibgTRdwjohEZWfJKB6zU/0"

},

"code": {

"errcode": 0,

"errmsg": "success"

}

返回参数：

A：不一样，华邦开放平台的access token是基于华邦科技产品业务接口而使用的，是不能再用于微信接口调用开发的。

Q：华邦接口调用次数是否有限制？

A：目前华邦每个接口每日调用次数上限为100万次。默认情况下，每个接口都不能超过一定限制，当超过一定限制时，调用对应接口会收到如下错误返回码：
{"code": {"errcode": 8000103,"errmsg": "exceed the api call limit"}}

1、通过code拿到access token和refresh_token。
2、access token有效期2h，refresh token最高上限7天+2h。3、用refresh token刷新获取新的access token，每次刷新refresh token有效期增加2h（refresh token有效时间从刷新这一刻计算，不是从第一次获取计算）。*如果走服务市场购买授权的话，refresh token时长是购买周期。4、建议保证2h内至少自动刷新一次。（备注：需使用主账号登录授权）

A：常见的错误信息：

invalid_client：参数client_id错误，检查后重新填写。

Bad client Credentials：可以检查下参数中是否存在空格，client_id或者client_secret错误，检查后重新填写。

redirect_uri mismatch：跳转地址不匹配，检查后重新填写。获取token这个过程，redirect_uri跳转地址是必须的，同时需要同应用填写的跳转地址完全匹配。