登录任务状态查询

POST

openapi.nmy.cn/api/v1/open/login/login-status

接口描述

该接口用于查询电子税务局登录任务的执行状态。

该接口需轮询调用，以任务 ID 为索引进行状态追踪。当返回状态为「成功」或「失败」时，任务终止，无需继续轮询；当返回状态为「等待短信验证码」时，应提示用户及时输入短信验证码。

⚠️ 请求头说明：accountId 为条件可选请求头，根据查询目的决定是否携带：
不携带 accountId：仅查询当前任务执行状态（如是否已发送短信验证码、是否等待验证等），适用于登录流程中尚未获得 accountId 的阶段；
携带 accountId：同时检查是否已存在有效的登录缓存，适用于已持有 accountId 时判断是否可复用已有会话。
登录成功之前无法获取 accountId，此阶段请勿携带该请求头。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "uscc": "{{uscc}}",
    "personalAccount": "{{personalAccount}}",
    "taskId": 12345
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'openapi.nmy.cn/api/v1/open/login/login-status' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "personalAccount": "{{personalAccount}}",
    "taskId": 12345
}'

返回响应

🟢200

application/json

Success

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "status": 1,
        "data": {
            "cookie": {
                "timestamp": "2024-01-01T00:00:00Z",
                "token": "example",
                "newKey16": "example"
            },
            "phone": "13212345678",
            "sflx": "BSY",
            "nsrzg": 1,
            "uuid": "********-****-****-****-************",
            "taskId": 12345,
            "sentTime": "2024-01-01T00:00:00Z",
            "accountId": "税局账号id",
            "loginLevel": "认证等级"
        }
    },
    "traceId": "xxxx-xxxx-xxxx-xxxx"
}

🟠400

🟠401

🔴500

修改于 2026-09-29 07:58:32

创建代理企业登录任务

提交短信验证码

登录任务状态查询

接口描述#

请求参数

请求示例代码

返回响应

接口描述