# huaweicloud-msgsms-app-manage-java **Repository Path**: HuaweiCloudDeveloper/huaweicloud-msgsms-app-manage-java ## Basic Information - **Project Name**: huaweicloud-msgsms-app-manage-java - **Description**: 华为云MSGSMS服务为企业用户(不包括个体工商户、个人独资企业、合伙企业等非法人主体或组织)提供单发、群发短信服务,同时可接收用户回复短信。 此项目主要提供关于应用管理的示例代码 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master-dev - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2023-04-27 - **Last Updated**: 2025-06-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## 功能介绍 **什么是华为云MSGSMS服务?** 华为云MSGSMS服务为企业用户(不包括个体工商户、个人独资企业、合伙企业等非法人主体或组织)提供单发、群发短信服务,同时可接收用户回复短信。 MSGSMS服务提供的短信发送能力,包括国内短信和国际/港澳台短信,具体如下: * 国内短信:向中国大陆号码发送短信。支持发送验证码、通知和推广短信。国内短信支持三网合一(移动,联通,电信,新增支持广电)专属通道。 * 国际短信:向国际/港澳台号码发送英文及其他语种短信。仅支持发送验证码和通知短信。 注:国际/港澳台短信无签名,模板不区分类型,不可接收用户回复短信。 短信发送形式:可开发代码调用API,或使用群发助手发送短信。 企业客户在发送短信前,需要先通过MSGSMS服务的Console或API创建短信应用、短信模板,国内短信业务还需要创建短信签名。 * 短信应用:短信应用是用户使用华为公有云短信服务的载体。创建应用后,系统会自动分配全局唯一的APP_Key和APP_Secret、APPID(应用主键ID),并提供APP接入地址。其中,APP_Key和APP_Secret是用户身份的唯一标识,调用短信业务API时需携带,用于认证鉴权。APPID是后续调用签名管理、模板管理相关接口所需的参数。 * 短信签名:短信签名是根据用户身份来创建的符合自身属性的签名信息,需审核通过后才能使用。短信签名只针对国内短信场景使用。 例如,手机终端收到的短信为“【华为云】您的验证码为:123456(5分钟内有效),为了保证您的账户安全,请勿向任何人提供此验证码”,其中,“【华为云】”为短信签名。 * 短信模板:短信模板是用户发送短信时使用的内容模板,由纯固定文本或固定文本加变量组成。模板创建后,只有变量可以按规则变化,替换成符合格式要求的指定内容。 **您将学到什么?** 华为云提供了 MSGSMS 服务端 SDK,您可以直接集成服务端 SDK 来调用 MSGSMS 的相关 API,从而实现对 MSGSMS 的快速操作。 该场景示例代码以短信应用为例,介绍如何使用MSGSMS Java SDK创建短信应用、更新短信应用及获取应用详情。创建的应用可用于后续创建短信签名及短信模板使用。 ## 前置条件 - 1、需要是华为云企业认证账号,并开通华为云MSGSMS云服务。 - 2、获取华为云开发工具包(SDK),华为云提供了多种语言的SDK。本示例代码使用了Java SDK,也给出了在Java项目的pom.xml文件引入依赖的示例。 - 3、您需要拥有华为云账号以及该账号对应的 Access Key(AK)、Secret Access Key(SK)和IAM项目ID(PROJECT ID)。获取方法可参考[获取帐号、用户、项目的名称和ID](https://support.huaweicloud.com/api-msgsms/sms_05_0020.html)。 ## 接口参数说明 场景示例代码是基于SDK开发的,其中涉及到的Restful API接口与示例代码SDK接口对应关系如下: | 接口功能 | Restful API接口 | SDK接口 | |:-------|:--------------------------------------|:----------| | 创建短信应用 | POST /v2/{project_id}/msgsms/apps | createApp | | 查询短信应用 | GET /v2/{project_id}/msgsms/apps | showApp | | 修改短信应用 | PUT /v2/{project_id}/msgsms/apps/{id} | updateApp | 相关接口参数的详细说明可参见:[“短信应用API”](https://support.huaweicloud.com/api-msgsms/sms_05_0023.html) 。 ### SDK获取和安装 开发者可以通过Maven方式获取和安装SDK,包括“huaweicloud-sdk-core”和“huaweicloud-sdk-msgsms”。需要在Java项目的pom.xml文件中加入如下的依赖项。 ```xml com.huaweicloud.sdk huaweicloud-sdk-msgsms 3.1.38 ``` ## 示例代码 ```java public class MsgsmsAppManageDemo { public static void main(String[] args) { System.out.println("Start HUAWEI CLOUD MSGSMS App Manage Java Demo..."); ICredential auth = getCredential("YOUR AK", "YOUR SK","YOUR PROJECT ID"); // 创建MsgsmsClient实例 MsgsmsClient client = getClient(MsgsmsRegion.CN_NORTH_4, auth); try { String appId = createApp(client); showApp(client, appId); updateApp(client, appId); } catch (ConnectionException | RequestTimeoutException e) { System.out.println(e.getMessage()); } catch (ServiceResponseException e) { System.out.println(e.getHttpStatusCode()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } /** * 创建短信应用 * @param client MsgsmsClient实例 * @return 应用主键ID */ private static String createApp(MsgsmsClient client) { CreateAppRequest request = new CreateAppRequest(); SmsAppAddReq body = new SmsAppAddReq(); body.setAppName("myTestApp"); body.setRegion("cn"); body.setEnterpriseProjectId("0"); body.setEnterpriseProjectName("default"); request.withBody(body); // 调用SDK的接口创建应用 CreateAppResponse response = client.createApp(request); System.out.println(response.toString()); return response.getId(); } /** * 获取应用详情 * @param client MsgsmsClient实例 * @param appId 应用主键ID */ private static void showApp(MsgsmsClient client, String appId) { ShowAppRequest request = new ShowAppRequest(); request.setId(appId); // 调用SDK的接口获取应用详情 ShowAppResponse response = client.showApp(request); System.out.println(response.toString()); } /** * 更新短信应用 * @param client MsgsmsClient实例 * @param appId 应用主键ID */ private static void updateApp(MsgsmsClient client, String appId) { UpdateAppRequest request = new UpdateAppRequest(); SmsAppUpdateReq body = new SmsAppUpdateReq(); body.setAppName("myTestAppNew"); body.setRegion("cn"); body.setEnterpriseProjectId("0"); body.setEnterpriseProjectName("default"); request.withBody(body); request.setId(appId); // 调用SDK的接口更新应用 UpdateAppResponse response = client.updateApp(request); System.out.println(response.toString()); } /** * 创建鉴权凭证 * @param ak 租户账号对应的Access Key (AK) * @param sk 租户账号对应的Secret Access Key (SK) * @param projectId 租户账号对应的IAM项目ID * @return 鉴权凭证 */ public static ICredential getCredential(String ak, String sk, String projectId) { return new BasicCredentials() .withAk(ak) .withSk(sk) .withProjectId(projectId); } /** * 创建Msgsms client * @param region region信息 * @param auth 鉴权凭证 * @return MsgsmsClient实例 */ public static MsgsmsClient getClient(Region region, ICredential auth) { // 使用默认配置 HttpConfig config = HttpConfig.getDefaultHttpConfig(); config.withIgnoreSSLVerification(true); // 初始化Msgsms服务的客户端 return MsgsmsClient.newBuilder() .withHttpConfig(config) .withCredential(auth) .withRegion(region) .build(); } } ``` ## 参考 更多信息请参考: - 1、[MSGSMS产品介绍](https://support.huaweicloud.com/productdesc-msgsms/sms_Infographics.html) - 2、[MSGSMS快速入门](https://support.huaweicloud.com/qs-msgsms/sms_02_0001.html) - 3、[MSGSMS开发指南](https://support.huaweicloud.com/devg-msgsms/sms_04_0000.html) - 4、[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/MSGSMS/doc?api=CreateApp) - 5、[API错误中心](https://apierrorcenter.developer.huaweicloud.com/apierrorcenter/errorcode?product=MSGSMS) - 6、[SDK中心](https://sdkcenter.developer.huaweicloud.com/?product=MSGSMS) ## 修订记录 | 发布日期 | 文档版本 | 修订说明 | | :--------: | :------: | :----------: | | 2023-04-28 | 1.0 | 文档首次发布 |