企享云API(适配版本)
  1. 自持登录
企享云API(适配版本)
  • 基本介绍
  • 快速开始
    • 开发必读
    • 对接地址
    • SDK集成
    • 认证鉴权
    • 接口调用
    • 加密说明
  • 前置流程
    • 业务指引
    • 证书申请指引
    • 证书对接前置流程
    • 小号申请指引
  • 公共业务
    • 鉴权
      • 获取access_token
    • 订购
      • 自然人获取企业列表
      • 订购产品
      • 订购取消
      • 订购查询
      • 企业取消授权
    • 自然人
      • 自然人创建接口
      • 自然人修改接口
      • 自然人删除接口
    • 通知预警
      • 客户通知
    • 附录
      • 地区代码
  • 登录业务
    • 简介
    • 登录
      • 托管模式
        • 登录接口
        • 通用账户创建
        • 账号启用
        • 登录电票平台接口
        • 校验电局账号有效性
      • 自持登录
        • 自然人同步登录接口
          POST
        • 自然人异步登录发送验证码接口
          POST
        • 异步登录校验税局缓存是否有效
          POST
        • 异步登录税局【发送短信验证码】
          POST
        • 扫码登录税局(二维码获取)
          POST
        • 扫码登录税局(二维码登录)
          POST
        • 异步登录税局【上传短信验证码登录】
          POST
        • 自然人异步登录税局【上传短信验证码登录】
          POST
        • 上传cookie接口
          POST
      • 校验appkey是否账户自持
        POST
    • 多账号管理
      • 托管模式
        • 托管账号创建
        • 托管账号修改
        • 托管账号删除
        • 托管账号查询
        • 账号产品绑定
        • 账号产品解绑
      • 自持登录
        • 校验异步登录税务数字账户缓存是否有效
        • 异步登录税务数字账户【发送短信验证码】
        • 异步登录税务数字账户【上传短信验证码登录】
  • 发票业务
    • 发票查验
      • 简介
      • 发票查验
      • 税号版数电票查验及版式文件下载
      • 发票查验版式文件下载结果查询
    • 发票认证
      • 简介
      • 发票勾选/代购代缴完税凭证勾选
      • 进项发票勾选结果查询
      • 海关缴款书勾选
      • 海关缴款书勾选结果查询
      • 申请统计接口
      • 发票同步
      • 海关缴款书同步
      • 申请统计
      • 申请统计结果查询
      • 抵扣统计结果获取
      • 多票采集接口
      • 申请确认
      • 申请确认结果查询
    • 发票附录
      • 发票附录
      • 数电票号码规则
  1. 自持登录

异步登录校验税局缓存是否有效

POST
/v2/public/login/ext/checkAsyncLoginSjCache

接口描述#

该接口用于36个地区的异步登录成功后,缓存的税局cookie是否有效。
支持加密参见:加密说明

请求参数

Header 参数
access_token
string 
必需
通过调用access_token接口返回的access_token值
示例值:
{{access_token}}
req_date
string 
必需
当前时间转为的毫秒数
示例值:
{{req_date}}
req_sign
string 
签名算法得到的签名
必需
示例值:
{{req_sign}}
Body 参数application/json
aggOrgId
integer 
企业id。用户在系统创建企业后获取
可选
如果用户在系统中创建过企业,传该值即可,其他参数不需要。
encryptionType
string 
加密类型
可选
1表示加密,默认0不加密
nsrsbh
string 
纳税人识别号
可选
不传aggOrgId时,该值必填
areaCode
string 
地区编码
可选
四川传值5100,青岛为3702。不传aggOrgId时,该值必填
gryhm
string 
用户名
可选
可为:居民身份证/手机号/用户名。不传aggOrgId时,该值必填
gryhmm
string 
个人用户密码
可选
不传aggOrgId时,该值必填,当encryptionType=1时该值必须加密
sflx
string 
身份类型
可选
FDDBR法定代表人、CWFZR财务负责人、BSY办税员、LPY领票人、QTRY其他人员、FBSR附办税人、PTGLY普通管理员、GPY购票员、SMBS实名办税、FPLYR发票领用人、KPY开票员。不传aggOrgId时,该值必填
sjhm
string 
手机号码
可选
除广东、天津、浙江、湖北外,不传aggOrgId时,该值必填
示例
//方式一:传参为指定登录信息
{
    "nsrsbh":"9151xxxxxxxxxxxxxx",
    "areaCode":"5100",
    "gryhm":"131xxxxxxxx",
    "grymm":"xxxxxx",
    "sflx":"BSY",
    "sjhm":"131xxxxxxxx"
}

//方式二:传参为指定企业aggOrgId
//{ 
//  "aggOrgId":4683858486xxx
//}

示例代码

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/login/ext/checkAsyncLoginSjCache' \
--header 'access_token: {{access_token}}' \
--header 'req_date: {{req_date}}' \
--header 'req_sign: {{req_sign}}' \
--header 'Content-Type: application/json' \
--data-raw '//方式一:传参为指定登录信息
{
    "nsrsbh":"9151xxxxxxxxxxxxxx",
    "areaCode":"5100",
    "gryhm":"131xxxxxxxx",
    "grymm":"xxxxxx",
    "sflx":"BSY",
    "sjhm":"131xxxxxxxx"
}

//方式二:传参为指定企业aggOrgId
//{ 
//  "aggOrgId":4683858486xxx
//}'

返回响应

🟢200成功
application/json
Body
reqId
string 
请求id
必需
由服务器端生成的唯一标识,对应每次请求。排查接口异常时,可提供该字段方便定位
code
string  | null 
错误码
必需
2000:接口成功;4xxx;登录信息有误;5xxx:系统错误
success
boolean 
是否成功标记
必需
接口是否成功(是否发生业务异常)
message
string 
错误信息
可选
data
boolean  | null 
返回结果
可选
true为缓存有效;false缓存失效
示例
{
    "code": "2000",
    "data": false,
    "success": true,
    "message": "",
    "reqId": "d8e97e6e88514e329f28386d2d07f6f0"
}
上一页
自然人异步登录发送验证码接口
下一页
异步登录税局【发送短信验证码】
Built with