客户通知 - 企享云API（适配版本）

该接口通过订阅消息，可以支持服务异常通知、税局变化通知、税局升级通知的获取，方便客户系统集成和实时提醒。
接口调用方式：客户轮询接口获取消息。
本接口只支持增量数据拉取，不支持历史数据拉取。

请求参数

Header 参数

access_token

string

可选

示例值:

req_date

string

可选

示例值:

req_sign

string

可选

示例值:

Body 参数application/json

noticeType

integer

通知类型

可选

不填写：所有类型通知；
10：平台维护通知；
20：税局维护通知；
30：税局异常通知；
31：税局恢复通知；
40：查验异常通知；
41：查验恢复通知；

示例

{
    "noticeType": 10
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

result

object

必需

success

boolean

是否成功

必需

req_id

string

必需

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

timestamp

integer

必需

time

integer

必需

value

array [object {4}]

必需

title

string

通知标题

必需

noticeType

integer

通知类型

必需

message

string

通知消息

必需

createTime

string

通知时间

必需

示例

成功示例查验异常通知示例查验恢复通知示例

{
    "result": {
        "success": true,
        "req_id": "bb59f4cae4574362ab238bbac427e1bc",
        "timestamp": 1704808383856,
        "time": 4
    },
    "value": [
     {
	    "title":"税局维护通知",
 		"noticeType":10,
 		"message":"税局升级",
 		"createTime":"2024-01-01 00:00:00"
      },
      {
"title":"查验异常通知",
 		"noticeType":40,
 		"message":"北京地区差异不稳定",
 		"createTime":"2024-01-01 00:00:00"
      }
]
}