接口调用说明

  本文档主要讲解接口调用过程中的重要步骤

  正式环境接口地址访问前缀:https://api.xinrenxinshi.com

一、接口访问流程

  1. 通过应用appKey和appSecret获取授权令牌access_token(详见:鉴权认证 )
  2. 调用方调用薪人薪事API,需携带access_token信息;参数传递策略如下:

     <1>. 调用业务接口,请在HTTP Header中携带授权令牌 access_token 信息。
     <2>. 调用免登跳转接口,请直接将access_token 信息设置到请求参数中。
    
  3. 请求参数需经过签名计算出签名值,并在参数中传递sign信息

  4. 调用方发送请求之前使用UTF-8进行URLEncoding处理,然后调用API
  5. 接收并解析API返回结果

二、公共参数说明

请求Header:

key value
access_token 获取的access_token的实际值
免登跳转相关接口无需在请求Header中设置access_token,需添加到请求参数中

公共请求参数

参数 类型 必传(Y/N) 说明
timestamp Integer Y 请求时间戳(精确到毫秒,5分钟内有效
sign String Y 请求参数签名

公共响应参数

参数 类型 必传(Y/N) 说明
errcode Integer Y 0成功,其他失败
errmsg String Y 操作结果描述

三、签名

  为防止请求数据被恶意篡改,每次请求业务接口时,需对请求参数进行签名计算, 薪人薪事开放平台会对请求中的sign签名进行验证,验证通过才会处理业务逻辑。

签名方式请参考签名规则

四、调用频率

  接口调用的频率默认限制为每分钟200次,如您有更高的调用需求请提交申请。

2020 © 企家有道网络技术(北京)有限公司版权所有@京ICP备15035315号 all right reserved,powered by Gitbookupdate by: 2020-12-16 14:23:56

results matching ""

    No results matching ""