接口功能介绍

获取自定义域名列表

接口约束

无

URI

GET /openapi/v1/domains/customdomains

路径参数
无

Query参数

参数	是否必填	参数类型	说明	示例	下级对象
pageIndex	是	Integer	页码	1
pageSize	是	Integer	每页大小	10

请求参数

请求头header参数

参数	是否必填	参数类型	说明	示例	下级对象
regionId	是	String	资源池id	test

请求体body参数
无

响应参数

参数	参数类型	说明	示例	下级对象
statusCode	Integer	状态码,0表示成功，非0表示不成功	0
error	String	错误码	CF_0
message	String	信息
returnObj	Object	返回实体		ReturnObj

表 ReturnObj

参数	参数类型	说明	示例	下级对象
data	Array of Objects	分页数据		Data
pagination	Object	分页信息		Pagination

表 Pagination

参数	参数类型	说明	示例	下级对象
pageIndex	Integer	页码
pageSize	Integer	每页大小
total	Integer	总记录数

表 Data

参数	参数类型	说明	示例	下级对象
createdAt	String	创建时间	2024-10-08T15:35:41.427170734+08:00
updatedAt	String	更新时间	2024-10-08T15:35:41.623015323+08:00
creator	Integer	创建者ID	17250
editor	Integer	编辑者ID	17250
certConfig	Object	HTTPS证书信息		CERTConfig
domainName	String	自定义域名	mozy.mzychaco.email
protocol	String	协议类型	HTTP
routeConfig	Object	路由表		RouteConfig
authConfig	Object	认证配置		AuthConfig
domainStatus	String	域名备案状态	0
filingStatus	Object	域名备案详细信息		FilingStatus
description	String	描述
cnameValid	Boolean	CNAME是否有效，仅在应用场景下有意义	false

表 CERTConfig

参数	参数类型	说明	示例	下级对象
certificate	String	证书
certName	String	证书名称
privateKey	String	私钥

表 RouteConfig

参数	参数类型	说明	示例	下级对象
routes	Array of Objects	路由映射		PathConfig

表 PathConfig

参数	参数类型	说明	示例	下级对象
enableJwt	Integer	是否启用JWT	0
functionId	Integer	函数ID	2807999806632073
functionName	String	函数名称	ccc
functionUniqueName	String	函数唯一名称	ccc-sykqwhnjwu
methods	Array of Strings	请求方法	[]
path	String	请求路径	/*
qualifier	String	函数版本	2

表 AuthConfig

参数	参数类型	说明	示例	下级对象
authType	String	认证类型	anonymous
jwtConfig	Object	JWT配置		JwtConfig

表 JwtConfig

参数	参数类型	说明	示例	下级对象
jwks	String	JWK字符串
tokenConfig	Array of Objects	Token配置		TokenConfig
matchMode	Object	JWT匹配模式，固定为All		MatchMode

表 TokenConfig

参数	参数类型	说明	示例	下级对象
location	String	Token读取位置
name	String	字段名

表 MatchMode

参数	参数类型	说明	示例	下级对象
mode	String	匹配模式	All
path	Array of Strings	匹配路径	[]

表 FilingStatus

参数	参数类型	说明	示例	下级对象
domain	String	一级域名	mzychaco.email
recordStatus	String	备案状态,0：未备案 1：已备案	0
recordNumber	String	备案号	-
errMessage	String	异常信息

枚举参数

无

请求示例

请求url

https://{host}/openapi/v1/domains/customdomains?pageIndex=1&pageSize=10

请求头header

无

请求体body

无

响应示例

{
    "statusCode": 0,
    "message": "",
    "returnObj": {
        "data": [{
            "createdAt": "2024-10-08T19:59:25.869382+08:00",
            "updatedAt": "2024-10-08T19:59:26.792778+08:00",
            "creator": 82647,
            "editor": 82647,
            "certConfig": {
                "certificate": "",
                "certName": "",
                "privateKey": ""
            },
            "domainName": "example.com",
            "protocol": "HTTP",
            "routeConfig": {
                "routes": [
                    {
                        "functionName": "funcA",
                        "functionUniqueName": "funca-yppopcjasv",
                        "functionId": 266,
                        "path": "/you/path",
                        "qualifier": "LATEST",
                        "rewriteConfig": {
                            "regexRules": null,
                            "wildcardRules": null
                        },
                        "enableJwt": 0
                    }
                ]
            },
            "authConfig": {
                "authType": "anonymous"
            },
            "domainStatus": "",
            "filingStatus": {
                "domain": "",
                "recordStatus": "",
                "recordNumber": "",
                "errMessage": "domain check is close"
            },
            "description": "",
            "cnameValid": false
        }],
        "pagination": {
            "pageIndex": 1,
            "pageSize": 10,
            "total": 1
        }
    }
}

状态码

请参考 状态码

错误码

请参考 错误码