接口调用说明
本文档主要讲解接口调用过程中的重要步骤
正式环境接口地址访问前缀:https://api.xinrenxinshi.com
一、接口访问流程
- 通过应用appKey和appSecret获取授权令牌access_token(详见:鉴权认证 )
调用方调用薪人薪事API,需携带access_token信息;参数传递策略如下:
<1>. 调用业务接口,请在HTTP Header中携带授权令牌 access_token 信息。 <2>. 调用免登跳转接口,请直接将access_token 信息设置到请求参数中。
请求参数需经过签名计算出签名值,并在参数中传递sign信息
- 调用方发送请求之前使用UTF-8进行URLEncoding处理,然后调用API
- 接收并解析API返回结果
二、公共参数说明
请求Header::
key | value |
---|---|
access_token | 获取的access_token的实际值 |
公共请求参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
timestamp | Integer | Y | 请求时间戳(精确到毫秒,5分钟内有效) |
sign | String | Y | 请求参数签名 |
公共响应参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 操作结果描述 |
三、签名
为防止请求数据被恶意篡改,每次请求业务接口时,需对请求参数进行签名计算, 薪人薪事开放平台会对请求中的sign签名进行验证,验证通过才会处理业务逻辑。
签名方式请参考签名规则
四、调用频率
接口调用的频率默认限制为每分钟200次,如您有更高的调用需求请提交申请。