文档首页/ 消息&短信 MSGSMS/ API参考/ API/ 应用、签名、模板/ 短信签名/ 获取签名详情
更新时间：2024-10-24 GMT+08:00
查看PDF
分享

获取签名详情

功能介绍

该接口用于用户查询签名详情信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/msgsms/signatures/{id}

表1 路径参数

参数

是否必选

参数类型

描述

id

是

String

签名主键ID，对应表5 响应SmsSignatureResp参数中的ID

project_id

是

String

项目ID，参考“获取帐号、用户、项目的名称和ID”

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

请求体参数类型，该字段必须设置为：application/json;charset=utf8

X-Auth-Token

是

String

用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码： 200

表3 响应SmsSignatureResp参数

参数

是否必选

参数类型

描述

id

否

String

签名主键ID，用于获取、修改、删除、申请激活签名的唯一标识

create_time

否

String

创建时间[yyyy-MM-dd HH:mm:ss]

update_time

否

String

更新时间[yyyy-MM-dd HH:mm:ss]

customer_id

否

String

租户customer ID

tentant

否

表4 TenantBasic

-

signature_name

否

String

签名名称

signature_id

否

String

签名ID

signature_type

否

String

签名类型

app_name

否

String

应用名称

apply_desc

否

String

申请描述

channel_num

否

String

国内短信通道号，仅当签名审核成功，运营人员配置完成后返回。

review_desc

否

String

审核意见

file_id

否

String

文件ID

status

否

String

状态

  • PENDING_REVIEW：待签名审核
  • PROCESSING：内容审核通过，签名处理中
  • REVIEW_PASSED：处理完毕（待补充资质），该状态仅针对存量签名补充资质有效。在该状态下，用户可发送短信，但发送短信可能会由于运营商资质管控而失败
  • REVIEW_NOT_PASS：审核不通过
  • TO_BE_ACTIVATED：待激活
  • PENDING_ACTIVATE：激活审核中
  • PENDING_QUALIFICATION_REVIEW：待资质审核，该状态下，用户不可发送短信
  • REAL_NAME_REGISTRATING：实名报备中
  • REVIEW_PASSED_QUALIFICATION_PROCESSING：处理完毕（资质审核中），该状态仅针对存量签名补充资质有效。在该状态下，用户可发送短信，但发送短信可能会由于运营商资质管控而失败
  • REVIEW_PASSED_REAL_NAME_REGISTRATING：处理完毕（实名报备中），该状态仅针对存量签名补充资质有效。在该状态下，用户可发送短信，但发送短信可能会由于运营商资质管控而失败
  • REVIEW_PASSED_REAL_NAME_REGISTRATE_FAIL：处理完毕（实名报备失败），该状态仅针对存量签名补充资质有效。在该状态下，用户可发送短信，但发送短信可能会由于运营商资质管控而失败
  • REVIEW_PROCESSING_COMPLETED：处理完毕

site

否

String

地域，取值范围：cn及hk ，当前该参数暂时不使用

signature_source

否

Integer

签名来源

is_involved_third

否

String

是否涉及第三方权益

power_attorney_file_id

否

String

授权委托书文件ID

urge_status

否

String

催审说明

urge_time

否

String

催审时间

urge_desc

否

String

催审描述

app_key

否

String

应用key

source_title_content

否

String

标题内容

signature_usage

否

String

签名用途

qualification_id

否

String

资质ID

qualification_name

否

String

资质名
表4 TenantBasic

参数

是否必填

参数类型

描述

customer_id

否

String

租户custom id

customer_name

否

String

租户custom name

enterprise_name

否

String

租户企业名称

请求示例

获取签名详情，请求方式：GET，请求URL：/v2/{project_id}/msgsms/signatures/{id}，路径参数：id，project_id，请求头参数：X-Auth-Token，Content-Type。

GET /v2/845ada5bc7444f1295cd517af0123da1/msgsms/signatures/07cfacbb-d48c-4c4d-b3da-baa8e4664852 
Host: 100.85.***.***:30300
Content-Type: application/json
X-Auth-Token:******

响应示例

{
    "create_time": "2022-08-12 07:14:18",
    "customer_id": "******c55c3c4526b2ed7a0213bc9871",
    "id": "******bb-d48c-4c4d-b3da-baa8e4664852",
    "signature_name": "auto_test789",
    "signature_id": "******1-196f-495f-abbe-42240469b8fc",
    "signature_type": "NOTIFY_TYPE",
    "app_name": "auto_test7890",
    "apply_desc": "test",
    "channel_num": "******1733968",
    "file_id": "******ab-1390-4268-9463-73db98cdc2e1",
    "status": "PENDING_REVIEW",
    "signature_source": 0,
    "is_involved_third": "No",
    "urge_status": "NO",
    "app_key": "******3baZf4c856O4Qrbqvui3K2",
    "signature_usage": "COMMERCIAL"
}

返回值

返回值

描述

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

500

System error
父主题： 短信签名

相关文档