InsertRefererInfo - 增量报备链接--多云安全平台-火山引擎

文档中心

立即注册

导航

InsertRefererInfo - 增量报备链接

最近更新时间：2025.04.11 15:32:20首次发布时间：2025.04.11 11:47:15

接口概述

功能：增量报备链接
HTTP 方法：POST

请求参数

Query 参数

参数名称	类型	是否必选	示例值	描述
Action	String	是	PostApiV1AssetSearchResultList	公共参数，本接口值：InsertRefererInfo。
Version	String	是	2023-05-01	公共参数，本接口值：2024-12-01。

Body 参数

参数名称	类型	是否必选	示例值	描述
VolcAppID	String	是	7290c601-8ed3-xxxx-xxxx-xxxxxxxxxxxx	火山appid
Referer	List	否	`[ { "Tag": "red", "Urls": [ "http://www.xxx.com" ] }, { "Tag": "green", "Urls": [ "http://color.cn" ] } ]`	增量报备的Referer信息。报备规则：一个URL不可以同时出现在多个Tag下一个产品使用一个Tag，即：一个tag下报备一个可以打开的url即可。报备URL应该遵循最小化原则，即：在保证产品功能无损的情况下URL的query参数应该尽可能少。

参数名称

类型

是否必选

示例值

描述

VolcAppID

String

是

7290c601-8ed3-xxxx-xxxx-xxxxxxxxxxxx

火山appid

Referer

List

否

[
    {
        "Tag": "red",
        "Urls": [
            "http://www.xxx.com"
        ]
    },
    {
        "Tag": "green",
        "Urls": [
            "http://color.cn"
        ]
    }
]

增量报备的Referer信息。
报备规则：

一个URL不可以同时出现在多个Tag下
一个产品使用一个Tag，即：一个tag下报备一个可以打开的url即可。
报备URL应该遵循最小化原则，即：在保证产品功能无损的情况下URL的query参数应该尽可能少。

响应参数

参数名称	类型	示例值	描述
Result	Object of InsertRefererInfoResponse	--	响应结果

InsertRefererInfoResponse

参数名称	类型	示例值	描述
msg	string	“”	业务报错信息，请求正常则为空

请求示例

curl --location --request POST 'https://open.volcengineapi.com/api/v1/operator/new_updateApp?Version=2024-12-01&Action=InsertRefererInfo' \
--header 'X-Date: 20250221T081658Z' \
--header 'Host: open.volcengineapi.com' \
--header 'Authorization: HMAC-SHA256 Credential=AKLTxxxxxxxx/20250221/cn-beijing/mcs/request, SignedHeaders=host;x-date, Signature=xxxxxxxxxxxxxxxx' \
--header 'Connection: keep-alive'
--data-raw '{
    "VolcAppID": "1fa67606-2187-412b-a5d3-ee5b04f6e077",
    "Referer": [
        {
            "Tag": "test1",
            "Urls": [
                "http://www.test1.com"
            ]
        },
        {
            "Tag": "test2",
            "Urls": [
                "http://www.test2.com"
            ]
        }
    ]
}'