企享云API(适配版本)
  1. 鉴权
企享云API(适配版本)
  • 基本介绍
  • 快速开始
    • 开发必读
    • 对接地址
    • SDK集成
    • 认证鉴权
    • 接口调用
    • 加密说明
  • 前置流程
    • 业务指引
    • 证书申请指引
    • 证书对接前置流程
    • 小号申请指引
  • 公共业务
    • 鉴权
      • 获取access_token
        POST
    • 订购
      • 自然人获取企业列表
      • 订购产品
      • 订购取消
      • 订购查询
      • 企业取消授权
    • 自然人
      • 自然人创建接口
      • 自然人修改接口
      • 自然人删除接口
    • 通知预警
      • 客户通知
    • 附录
      • 地区代码
  • 登录业务
    • 简介
    • 登录
      • 托管模式
        • 创建用户
        • 登录接口
        • 通用账户创建
        • 账号启用
        • 登录电票平台接口
        • 校验电局账号有效性
      • 自持登录
        • 自然人同步登录接口
        • 自然人异步登录发送验证码接口
        • 异步登录校验税局缓存是否有效
        • 异步登录税局【发送短信验证码】
        • 扫码登录税局(二维码获取)
        • 扫码登录税局(二维码登录)
        • 异步登录税局【上传短信验证码登录】
        • 自然人异步登录税局【上传短信验证码登录】
        • 上传cookie接口
      • 校验appkey是否账户自持
    • 多账号管理
      • 托管模式
        • 托管账号创建
        • 托管账号修改
        • 托管账号删除
        • 托管账号查询
        • 账号产品绑定
        • 账号产品解绑
      • 自持登录
        • 校验异步登录税务数字账户缓存是否有效
        • 异步登录税务数字账户【发送短信验证码】
        • 异步登录税务数字账户【上传短信验证码登录】
  • 发票业务
    • 海关进出口
      • 获取退税报关单
      • 进出口报关单获取
      • 出口报关单打印
      • 获取通关无纸化出口放行通知书PDF文件
      • 获取电子委托协议PDF文件
      • 获取购销合同PDF文件
      • 获取装箱单PDF
    • 发票附录
      • 发票附录
      • 数电票号码规则
  1. 鉴权

获取access_token

POST
/v2/public/oauth2/login
获取token

接口描述#

本开放接口,针对合作接入方,以REST风格的HTTP服务接口方式,或模块界面集成方式,提供发票、税务相关能力服务。
客户系统可以根据自己系统的情况,选择不同的实现语言来实现对接。本文档以java为主要示例语言。
对接请参考:认证鉴权

请求参数

Body 参数application/json
grant_type
string 
必需
client_appkey
string 
必需
client_secret
string 
必需
示例
{
    "grant_type":"client_credentials",
    "client_appkey":"{{client_appkey}}",
    "client_secret":"{{client_secret}}"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/public/oauth2/login' \
--header 'Content-Type: application/json' \
--data-raw '{
    "grant_type":"client_credentials",
    "client_appkey":"{{client_appkey}}",
    "client_secret":"{{client_secret}}"
}'

返回响应

🟢200成功
application/json
Body
code
string 
业务异常状态码
必需
message
string  | null 
业务异常消息
可选
reqId
string 
请求id
必需
success
boolean 
是否成功
必需
默认值:
true
data
object  | null 
业务数据
可选
access_token
string 
必需
token_type
null 
必需
expires_in
integer 
必需
refresh_token
string 
必需
token_parameter
null 
必需
code
null 
必需
error_msg
null 
必需
result
boolean 
必需
userId
null 
必需
orgId
null 
必需
示例
{
    "code": "2000",
    "message": null,
    "success": true,
    "reqId": "75e20c4a7eec4ac0b42f9b3cdf223392",
    "data": {
        "access_token": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJbLTEsLTEsLTEsMTAwLFwiXCIsMTAwMDE5OTksbnVsbCxcIlwiLC0xLG51bGxdIiwiZXhwIjoxNjc5NjI2MjI1LCJpYXQiOjE2NzgzMzAyMjV9.vrjbsmJv4Fi9FtpfI2x8DOxWwQGsiDNd75aIiR0Wy0VJvFtjy_7QMFIz4lmibud5LSoPMY7sGdC1_6KQ-fYrIw",
        "token_type": null,
        "expires_in": 1296000000,
        "refresh_token": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJbLTEsLTEsLTEsMTAwLFwiXCIsMTAwMDE5OTksbnVsbCxcIlwiLC0xLG51bGxdIiwiZXhwIjoxNjgwOTIyMjI1LCJpYXQiOjE2NzgzMzAyMjV9.3c99IHVh1OfIxYx_VTnoSwk9hmqsgqyhnqy23xrQodMamKY-xBGAMq7GP3nPk5X_aCQCE-jhH8g3aJbT-aS-aA",
        "token_parameter": null,
        "code": null,
        "error_msg": null,
        "result": true,
        "userId": null,
        "orgId": null
    }
}
上一页
小号申请指引
下一页
自然人获取企业列表
Built with