SDK Documentation

Choose your language and integrate SMS sending in minutes.

Installation

terminal

<dependency>
    <groupId>net.maiyun</groupId>
    <artifactId>sms-sdk</artifactId>
    <version>1.0.0</version>
</dependency>

Send SMS

Java

Example.java

import net.maiyun.sms.SmsClient;
import net.maiyun.sms.SendRequest;
import net.maiyun.sms.SendResponse;

public class Example {
    public static void main(String[] args) {
        SmsClient client = new SmsClient("YOUR_API_KEY");

        // --- send ---
        SendRequest req = new SendRequest();
        req.setPhone("8613800138000");
        req.setText("Your verification code is 123456, valid for 5 minutes.");

        SendResponse res = client.send(req);

        if (res.getResult() == 1) {
            System.out.println("uid: " + res.getUid());
        } else {
            System.out.println("error: " + res.getError());
        }
    }
}

Important Notes

1Phone numbers must include country code, e.g. 8613800138000 (86 = China Mainland).

2Keep your API Key secret. Never expose it in client-side code; use environment variables.

3Messages over 160 chars (70 for Chinese) are auto-split into multiple segments.

4Save the returned uid to track delivery status in the console.