GetSPSign - 获取运营商签名--多云安全平台-火山引擎

文档中心

立即注册

导航

GetSPSign - 获取运营商签名

最近更新时间：2025.04.01 20:08:44首次发布时间：2024.12.20 16:16:50

接口概述

功能：获取运营商签名，用于初始化 SDK。
HTTP 方法：GET

请求参数

Query

参数名称	类型	是否必选	示例值	描述
Action	String	是	PostApiV1AssetSearchResultList	公共参数，本接口值：GetSPSign。
Version	String	是	2024-12-01	公共参数，本接口值：2024-12-01。
VolcAPPID	String	是	43a40cb4-18bf-47c2-939e-cb802418a1f4	APP ID，用户可从前端控制台获得
SignVersion	String	是	2.0	签名版本号，无WIFI取号版本填写 1.0， WIFI取号版本填写 2.0

响应参数

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

GetSPSignResult

参数名称	类型	是否必选	示例值	描述
ChinaMobile	Object of GetSPSignResultValue	是	--	移动信息
ChinaTelecom	Object of GetSPSignResultValue	是	--	电信信息
ChinaUnicom	Object of GetSPSignResultValue	是	--	联通信息

GetSPSignResultValue

参数名称	类型	是否必选	示例值	描述
APPID	String	是	3000xxxxx885	运营商APPID
SPSign	String	是	3E556C03Axxxxxxxxxxxx4F284C27EE	运营商签名，有效期为5分钟，不可重复使用
TraceID	String	是	92b024fe-xxxxxxxxxxxx-47b5c105571a	运营商TraceID
TimeStamp	String	是	20241230170456000	运营商时间戳

请求示例

curl --location 'https://open.volcengineapi.com/api/v1/flow/get_sp_sign?Version=2024-12-01&Action=GetSPSign&VolcAPPID=43a40cb4-18bf-47c2-939e-cb802418a1f4' \
--header 'Authorization: HMAC-SHA256 Credential=AKLTxxxxxxxx/20250221/cn-beijing/mcs/request, SignedHeaders=host;x-date, Signature=xxxxxxxxxxxx' \
--header 'X-Date: 20250221T080840Z' \
--header 'Accept: */*' \
--header 'Host: open.volcengineapi.com' \
--header 'Connection: keep-alive'

返回示例

{
     "ResponseMetadata": {
         "RequestID": "",
         "Action": "",
         "Version": "",
         "Service": "",
         "Region": ""
     },
     "Result": {
         "ChinaMobile": {
             "APPID": "300012819885",
             "SPSign": "3E556C03AE5964B5A011C44F284C27EE",
             "TraceID": "92b024fe-3f73-4f16-824d-47b5c105571a",
             "TimeStamp": "20241230170456000"
         },
         "ChinaTelecom": {
             "APPID": "",
             "SPSign": "",
             "TraceID": "",
             "TimeStamp": ""
         },
         "ChinaUnicom": {
             "APPID": "",
             "SPSign": "",
             "TraceID": "",
             "TimeStamp": ""
         }
     }
 }

公共错误码
本服务 API 暂无特有错误码，公共错误码，请参见火山引擎公共错误码。