申请企业实名资质-ApplySignatureIdent--短信服务-火山引擎

文档中心

立即注册

导航

申请企业实名资质-ApplySignatureIdent

最近更新时间：2025.11.21 15:21:59首次发布时间：2024.12.17 11:44:53

短信服务使用方可以调用ApplySignatureIdent接口申请资质

使用方法

请求方式：POST
接口地址：https://sms.volcengineapi.com/?Action=ApplySignatureIdent&Version=2021-01-11

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	ApplySignatureIdent	要执行的操作，取值：ApplySignatureIdent。
Version	String	是	2021-01-11	API的版本，取值：2021-01-11。
materialName	String	是	资质1	资质名称，最多20个字符
businessInfo	BusinessInfo	是	企业信息结构体	企业信息
operatorPerson	PersonInfo	是	经办人信息	经办人信息
responsiblePersonInfo	PersonInfo	是	责任人信息	责任人信息
legalPerson	PersonInfo	否	法人信息	法人信息
powerOfAttorney	Array of SignAuthFile	否	授权委托书文件	授权委托书，当用途为他用时必填
purpose	Integer	是	1	资质用途，1：自用，2：他用

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
id	Big Integer	582712331329	资质id（请使用64位int存储该id）

请求示例

POST /?Action=ApplySignatureIdent&Version=2021-01-11 HTTP/1.1
Host: https://sms.volcengineapi.com/BatchBindSignatureIdent
Content-Type: application/json; charset=UTF-8
X-Date: 20240618T014855Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240618/cn-beijing/volcSMS/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "materialName": "2D6VktxOY",
  "businessInfo": {
    "businessCertificateType": 1,
    "businessCertificate": {
      "fileContent": "data:image/jpg;base64,IPV*****************************************************************CYII=",
      "fileSuffix": "jpg",
      "fileType": 0,
      "fileUrl": "at2hdE1bbau"
    },
    "businessCertificateName": "NXWL621PJMD",
    "unifiedSocialCreditIdentifier": "Zf6m",
    "businessCertificateValidityPeriodStart": "2024-01-12",
    "businessCertificateValidityPeriodEnd": "2024-01-12",
    "legalPersonName": "Hx"
  },
  "operatorPerson": {
    "certificateType": 0,
    "personCertificate": [],
    "personName": "L23sBtG",
    "personIDCard": "hxzgkU8aH",
    "personMobile": "zOb"
  },
  "responsiblePersonInfo": {
    "certificateType": 0,
    "personCertificate": [],
    "personName": "ek8J433e8mU",
    "personIDCard": "vFXKH",
    "personMobile": "52Tbt"
  },
  "legalPerson": {
    "certificateType": 0,
    "personCertificate": [],
    "personName": "ek8J433e8mU",
    "personIDCard": "vFXKH",
    "personMobile": "52Tbt"
  },
  "powerOfAttorney": [
    {
      "fileContent": "data:image/jpg;base64,IPV*****************************************************************CYII=",
      "fileSuffix": "jpg",
      "fileType": 0,
      "fileUrl": "VlqP73C9VP1"
    }
  ],
  "purpose": 1
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20240617205533020030226132786E58",
    "Action": "ApplySignatureIdent",
    "Version": "2021-01-11",
    "Service": "volcSMS",
    "Region": "cn-beijing"
  },
  "Result": {
    "id": 73
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
200	1001	参数错误	参数错误
200	1999	系统错误	系统错误
200	1023	no permission	没有接口调用权限