接入文档 /基础数据/获取访问令牌

获取访问令牌

用密钥换取与用户标识绑定的 accessToken，供前端页面、H5、登录&认证卡片等不便保存密钥的场景调用接口。该接口需要由业务系统后端调用并封装，再提供给自己的前端使用。

GET/access-token

请求参数

参数	类型	必填	说明
appKey	string	必填	服务密钥 Key
appSecret	string	必填	服务密钥 Secret
username	string	必填	用户标识：客户系统中的用户唯一编号，可以是手机号或加密字符串。用于登录&认证卡片时必须是开票员的电子税务局手机号（已在控制台「员工管理」中配置）
taxNumber	string	必填	企业纳税人识别号，指定令牌所属的企业

bash

curl "https://fapiao-api.easyapi.com/access-token?appKey=你的appKey&appSecret=你的appSecret&username=13600000000&taxNumber=91320211MA1WML8X6T"

响应示例

json

{
  "code": 1,
  "message": "获取成功",
  "content": {
    "accessToken": "k3d8s9a1b2c3d4e5f6g7h8i9j0k1l2m3",
    "username": "13600000000",
    "taxNumber": "91320211MA1WML8X6T"
  }
}

字段	类型	说明
accessToken	string	访问令牌，32 位
username	string	绑定的用户标识
taxNumber	string	令牌所属企业税号

有效期

令牌有效期 2 小时。有效期内重复调用返回同一令牌；过期后调用返回新令牌。
同一企业下每个 username 对应一个令牌，不同用户互不影响。
使用令牌调用接口的方式见鉴权方式 - 访问令牌模式。

错误信息

message	说明
用户标识username字段不能为空	未传 `username`
仅支持appKey模式访问	该接口只能用密钥调用，不能用令牌换令牌
认证失败	密钥错误