异步登录税局【发送短信验证码】

请求参数

Header 参数

access_token

string

必需

示例值:

req_date

string

必需

示例值:

req_sign

string

必需

待签名字符串 = HTTPMethod + "" + Content-Md5 + "" + req_date + "" + access_token + "" + AppSecret

示例值:

Body 参数application/json

aggOrgId

integer

企业id。用户在系统创建企业后获取

可选

如果用户在系统中创建过企业，传该值即可，其他参数不需要。

encryptionType

integer | null

加密类型

可选

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",
    "gryhmm":"xxxxxx",
    "sflx":"BSY",
    "sjhm":"131xxxxxxxx"
}

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

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v2/public/login/ext/etaxcookie' \
--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",
    "gryhmm":"xxxxxx",
    "sflx":"BSY",
    "sjhm":"131xxxxxxxx"
}

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

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位

code

string | null

登录返回的code

必需

2000：登录成功；4xxx;登录信息有误;8xxx短信发送频繁；5xxx:系统错误

success

boolean

是否成功标记

必需

接口是否成功（是否发生业务异常）

message

string

错误信息

可选

data

object

业务数据

可选

当code为2000，从data获取任务id或者登录结果

dppt

object

登录数字账户信息

可选

taskId

string

发送短信成功的id，推送短信接口的传参

可选

示例

发送短信成功结果示例异常示例登录成功示例

{
    "req_id": "0f1fe24daa164e95b0191f80a2bf11fc",
    "success": true,
    "code": "2000",
    "data": {
        "taskId": 1671038727830339600
    }
}

接口描述#

请求参数

示例代码

返回响应

接口描述