文档中心

# 登录获取短信验证码

# 应用场景

该接口适用于登录获取短信验证码（包含账密登录和自主登录方式）。用于登录电子税务局，获取短信上报。在用户收到短信验证码后需尽快调用短信验证码上报接口上报。

# 地址

/tax-api/invoice/login/check/v1

# 请求参数

参数名称 类型 必填 描述 示例
taxpayer_id string 是 纳税人识别号
terminal_code string 是 税盘号：
全电发票同当前商户税号
stage string 否 长效版必传
当该接口返回的code不为0时将code的值传入		 1

# 响应参数

字段 类型 必须 备注
code int 是 0表示获取短信验证码成功，非0表示失败，失败短信，重新登录获取短信。
massage string 是 错误描述
session_token string 是 session_token 长效版必定返回该值
用于跟踪上报短信验证码

# 请求示例

{
    "taxpayer_id": "XXXX",
    "terminal_code":"XXXX"
}

# 响应示例

{
  "code": 0,
  "message": "ok"
}

# 长效版请求示例

# 第一次请求

{
    "taxpayer_id": "XXXX",
    "terminal_code":"XXXX"
}

# 第一次响应

{
     "code": 1,
    "message": "设置失败，请先进行验证码登录即可设置成功",
    "session_token": ""
}

# 第二次请求

{
    "taxpayer_id": "XXXX",
    "terminal_code":"XXXX",
	"stage": "1" #这里传第一次响应的code值
}

# 第二次响应

{
     "code": 0,
    "message": "验证码已发送到 176****7315,
    "session_token": "78d6847fe271b74"
}

长效版登陆特别说明

  • 只有掉线以后才会返回需要登陆的提示
  • 登陆是两阶段调用
  • 在未掉线的情况下调用本接口会提示已经登陆，无需验证码

← 下一篇：短信验证码上报 →