开发者文档中心

为开发者提供短信、人机验证、SSL等产品的 API 接入指南与多种开发语言 SDK

短信服务 SDK

Java SDK 接入指南

已发布至 Maven Central,基于 OkHttp 实现,支持 Maven / Gradle 快速引入,可与 Spring、Spring Boot 等主流 Java 框架无缝集成。

1. 安装

Maven(推荐)

pom.xml
<dependency>
    <groupId>com.luosimao</groupId>
    <artifactId>luosimao-sms-sdk</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle

build.gradle
implementation 'com.luosimao:luosimao-sms-sdk:1.0.0'

2. 快速开始

2.1 发送短信

SmsDemo.java
import com.luosimao.sms.SmsClient;
import com.luosimao.sms.model.SmsResponse;

public class SmsDemo {
    public static void main(String[] args) {
        // 初始化客户端
        SmsClient client = new SmsClient("YOUR_API_KEY");

        try {
            // 发送短信
            SmsResponse response = client.send("13761528269", "验证码:1234【公司签名】");

            if (response.getError() == 0) {
                System.out.println("发送成功,批次号:" + response.getBatchId());
            } else {
                System.out.println("发送失败:" + response.getMsg());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3. Spring Boot 集成示例

SmsService.java
@Service
public class SmsService {

    private final SmsClient smsClient;

    public SmsService() {
        this.smsClient = new SmsClient("YOUR_API_KEY");
    }

    public void sendVerifyCode(String mobile, String code) {
        String message = String.format("验证码:%s【公司签名】", code);
        smsClient.send(mobile, message);
    }
}

4. 源码与资源

访问 GitHub 仓库 查看完整源码及 Release 记录。