1. HTTP应用
标准Open API
  • 管理后台接口
    • 开发前必读
    • 身份管理
      • 用户
        • 校验账号是否存在
        • 人员查询接口
        • 创建账号
        • 用户封禁接口
        • 用户注销接口(当前浏览器登入的会话)
        • 验证用户token是否有效
        • 用户注销登录 (用户所有登入会话包括终端)
        • 批量用户注销登录(标准版本不支持)
        • 获取终端用户在线状态(v4.0.11.8版本及以上可用)
      • 组织架构
        • 从指定用户组中移除指定账号
        • 校验指定用户组中是否有某个账号
        • 添加账号到指定用户组
        • 部门查询接口
    • 应用管理
      • HTTP应用
        • 域名端口存在校验
          POST
        • 应用发布
          POST
        • 应用更新
          POST
        • 删除应用(v4.0.10.3以上)
          POST
        • 应用详情(v4.0.10.3以上)
          POST
        • 应用列表接口(v4.0.8.0以上)
          POST
      • 隧道网关
        • 获取用户sdp网关接入状态
        • 创建隧道应用(v4.0.10.3以上)
        • 更新隧道应用(v4.0.10.3以上)
        • 删除隧道应用(v4.0.10.3以上)
        • 查询隧道应用详情(v4.0.10.3以上)
        • 下线sdp隧道连接(v4.0.12.4以上)
      • 授权管理
        • 添加HTTP应用到指定授权组
        • 授权策略详情(v4.0.10.3以上)
        • 授权策略列表查询(v4.0.10.3以上)
        • 更新授权策略(v4.0.10.3以上)
        • 创建授权策略(v4.0.10.3以上)
    • 主机运维网关
      • 主机组列表
      • 授权主机(主机添加负责人)
    • 终端管理
      • 资产管理
        • (新)删除可信资产(适用版本:4.0.11.0及以上)
        • (新)添加可信资产(适用版本:4.0.11.0及以上)
        • (新)获取可信资产列表(适用版本:4.0.11.0及以上)
        • (旧)删除可信资产(适用版本:4.0.8.0~4.0.10.X)
        • (旧)添加可信资产(适用版本:4.0.8.0~4.0.10.X)
        • (旧)获取可信资产列表(适用版本:4.0.8.0~4.0.10.0X)
      • 终端
        • 客户端注销登录
        • 终端状态信息拉取(4.0.8.1及以上版本支持)
        • 终端状态信息推送接口(4.0.8.1及以上版本支持)
        • 终端推送升级(4.0.11.0以上版本)
    • 组件管理
      • HTTP应用网关
        • 修改网关模式(4.0.8.0及以上版本可用)
        • 网关列表
    • 身份输出
      • 开发必读
      • 用户
        • 用户全量拉取(4.0.8.0及以上版本支持)
        • 用户增量拉取(4.0.8.0及以上版本支持)
      • 组织架构
        • 组织机构增量拉取(4.0.8.0及以上版本支持)
        • 组织机构全量拉取(4.0.8.0及以上版本支持)
    • API接口同步
      • API同步
    • IP地址池
      • 创建IP地址池(v4.0.15.0及以上)
      • 更新IP地址池(v4.0.15.0及以上)
      • 删除IP地址池(v4.0.15.0及以上)
      • 获取IP地址池列表(v4.0.15.0及以上)
  • 应用系统SSO对接
    • 零信任平台 OAuth2.0 协议对接指南
    • 零信任平台Cas协议对接指南
    • 零信任平台JWT协议对接指南
    • 零信任平台简易 SSO 对接指南
  1. HTTP应用

应用列表接口(v4.0.8.0以上)

POST
/ztpManage/v1/openApi/appFindList
接口签名详见 “开发前必读”

请求参数

Body 参数application/json

示例
{
    "page": 0,
    "size": 15,
    "name": "otp",
    "port":"60443",
    "portalType": {
        "portal": [
            "WEB"
        ],
        "noportal": "no"
    },
    "online": [
        1
    ],
    "gwMode": [
        "Bypass"
    ],
    "endData": "2024-11-13 15:07:24",
    "host": "otp.dev.sec.com",
    "linkBackAddr": "127.0.0.1:8080",
    "type": [
        "WEB"
    ],
    "orderby": "updated",
    "seq": "desc",
    "tagFilter": [
        {
            "field": "tag_group_id",
            "operator": "contains",
            "values": [
                2
            ]
        },
        {
            "field": "tag_id",
            "operator": "contains",
            "values": [
                2
            ]
        }
    ],
    "appApprover": "zhangsan",
    "gwId": 1,
    "unauthorized": 2,
    "expiringCertificate": 1,
    "enableWaterMark": "true",
    "enableAgentAccount": "true",
	"disableCopy":"true",
	"disableContext":"true",
	"debug":"true",
	"enableAuthip":"true",
	"enableWatermarkWhitelist":"true",
    "allowSelfApply": 1
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/ztpManage/v1/openApi/appFindList' \
--header 'Content-Type: application/json' \
--data '{
    "page": 0,
    "size": 15,
    "name": "otp",
    "port":"60443",
    "portalType": {
        "portal": [
            "WEB"
        ],
        "noportal": "no"
    },
    "online": [
        1
    ],
    "gwMode": [
        "Bypass"
    ],
    "endData": "2024-11-13 15:07:24",
    "host": "otp.dev.sec.com",
    "linkBackAddr": "127.0.0.1:8080",
    "type": [
        "WEB"
    ],
    "orderby": "updated",
    "seq": "desc",
    "tagFilter": [
        {
            "field": "tag_group_id",
            "operator": "contains",
            "values": [
                2
            ]
        },
        {
            "field": "tag_id",
            "operator": "contains",
            "values": [
                2
            ]
        }
    ],
    "appApprover": "zhangsan",
    "gwId": 1,
    "unauthorized": 2,
    "expiringCertificate": 1,
    "enableWaterMark": "true",
    "enableAgentAccount": "true",
	"disableCopy":"true",
	"disableContext":"true",
	"debug":"true",
	"enableAuthip":"true",
	"enableWatermarkWhitelist":"true",
    "allowSelfApply": 1
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 10000,
    "msg": "成功",
    "data": {
        "data": [
            {
                "id": 1,
                "name": "otp",
                "groupId": 0,
                "domainType": 0,
                "host": "otp.dev.chiansec.com",
                "protocol": "https1",
                "port": 0,
                "ports": "443,60035",
                "type": "WEB",
                "belong": "zhangyimian",
                "note": "",
                "serverConf": "{\"appProxyProtocol\":\"http\",\"availMasterServer\":\"\",\"availMasterServerExtendFields\":\"\",\"balanceAlgorithm\":\"\",\"appProxyWay\":\"single\",\"slaveServerAddressList\":null,\"slaveServerAddressListExtendFields\":null,\"balanceServerIpAddressList\":null,\"balanceServerExtendFields\":null,\"singleServerIp\":\"127.0.0.1:8001\",\"domainParseMode\":\"\",\"check\":false,\"checkUrl\":\"\",\"interval\":0,\"timeout\":0,\"fall\":0,\"rise\":0}",
                "online": 1,
                "gwMode": "Audit",
                "authLevel": 1,
                "creator": "admin",
                "modifier": "admin",
                "created": "2024-11-08T18:08:33+08:00",
                "updated": "2024-11-20T15:18:09+08:00",
                "lastVisitTime": "2024-11-08T18:48:33+08:00",
                "enableAuthip": 0,
                "authipWhitelist": "[]",
                "enableAgentAccount": 0,
                "enableDevid": 0,
                "portalType": [
                    "WEB",
                    "AGENT",
                    "APP"
                ],
                "appGateWay": [
                    {
                        "gwId": 1,
                        "gwName": "192.168.20.210-WEB",
                        "gwIp": "192.168.20.210",
                        "gwVip": "192.168.20.210",
                        "gwMode": "Standard"
                    }
                ],
                "visitCount": 0,
                "groupName": "",
                "cname": "张三",
                "apiGroupTotal": 0,
                "webGroupTotal": 1,
                "webSocketTotal": 0,
                "sslId": 0,
                "certName": "默认证书",
                "status": "",
                "tagRequestList": [
                    {
                        "id": 2,
                        "tagGroupId": 2,
                        "tagGroupName": "研发",
                        "name": "yanfa",
                        "type": "http_app_tag",
                        "description": ""
                    }
                ],
                "appPortalGroupRequest": [
                    {
                        "id": 1,
                        "groupName": "xxx",
                        "groupType": "",
                        "groupNote": "",
                        "created": "2024-11-07T17:58:45+08:00",
                        "updated": "2024-11-07T17:58:45+08:00",
                        "groupNameEn": "",
                        "weight": 1,
                        "appNumber": 0
                    }
                ],
                "allowSelfApply": 0,
                "standardModeWhiteList": "[]",
                "reloadError": "",
                "approvers": "",
                "waterMark": {
                    "id": 0,
                    "enable": 0,
                    "string": "",
                    "whitelist": null
                },
                "reloadStatus": 0,
                "auditModeWhiteList": "[\"192.168.40.13\"]",
                "enhancedControl": false,
                "ajaxRedirect": false
            },
            {
                "id": 2,
                "name": "otp1.dev.chiansec.comshi",
                "groupId": 0,
                "domainType": 0,
                "host": "otp1.dev.chiansec.com",
                "protocol": "https1",
                "port": 0,
                "ports": "443",
                "type": "WEB",
                "belong": "",
                "note": "",
                "serverConf": "{\"appProxyProtocol\":\"http\",\"availMasterServer\":\"\",\"availMasterServerExtendFields\":\"\",\"balanceAlgorithm\":\"\",\"appProxyWay\":\"single\",\"slaveServerAddressList\":null,\"slaveServerAddressListExtendFields\":null,\"balanceServerIpAddressList\":null,\"balanceServerExtendFields\":null,\"singleServerIp\":\"127.0.0.1:8001\",\"domainParseMode\":\"\",\"check\":false,\"checkUrl\":\"\",\"interval\":0,\"timeout\":0,\"fall\":0,\"rise\":0}",
                "online": 1,
                "gwMode": "Audit",
                "authLevel": 1,
                "creator": "admin",
                "modifier": "",
                "created": "2024-11-19T20:51:48+08:00",
                "updated": "2024-11-20T15:18:09+08:00",
                "lastVisitTime": null,
                "enableAuthip": 0,
                "authipWhitelist": "[]",
                "enableAgentAccount": 0,
                "enableDevid": 0,
                "portalType": null,
                "appGateWay": [
                    {
                        "gwId": 1,
                        "gwName": "192.168.20.210-WEB",
                        "gwIp": "192.168.20.210",
                        "gwVip": "192.168.20.210",
                        "gwMode": "Standard"
                    }
                ],
                "visitCount": 0,
                "groupName": "",
                "cname": "",
                "apiGroupTotal": 0,
                "webGroupTotal": 1,
                "webSocketTotal": 0,
                "sslId": 0,
                "certName": "默认证书",
                "status": "",
                "tagRequestList": [
                    {
                        "id": 2,
                        "tagGroupId": 2,
                        "tagGroupName": "研发",
                        "name": "yanfa",
                        "type": "http_app_tag",
                        "description": ""
                    }
                ],
                "appPortalGroupRequest": [
                    {
                        "id": 1,
                        "groupName": "xxx",
                        "groupType": "",
                        "groupNote": "",
                        "created": "2024-11-07T17:58:45+08:00",
                        "updated": "2024-11-07T17:58:45+08:00",
                        "groupNameEn": "",
                        "weight": 1,
                        "appNumber": 0
                    }
                ],
                "allowSelfApply": 0,
                "standardModeWhiteList": "[]",
                "reloadError": "",
                "approvers": "",
                "waterMark": {
                    "id": 0,
                    "enable": 0,
                    "string": "",
                    "whitelist": null
                },
                "reloadStatus": 0,
                "auditModeWhiteList": "[]",
                "enhancedControl": false,
                "ajaxRedirect": false
            }
        ],
        "total": 2
    }
}
修改于 2026-03-02 07:59:30
上一页
应用详情(v4.0.10.3以上)
下一页
获取用户sdp网关接入状态
Built with