Get Message Ringtones

Get the list of ringtones for configuring the message.

Operation Permissions

User login to Application Portal is not required.

Request Format

GET https://{apigw-address}/app-portal-service/v2.0/message/enum/ringtones

Response Parameters

Name Data Type Description
data Data Struct The list of ringtones for the message.

Data Struct

Name Data Type Description
ringings Ringing Struct The details of the ringtones for the message.

Ringing Struct

Name Data Type Description
id Integer The ringtone ID.
name I18nString Specify the ringtone name in its respective locale’s language. For more details on the structure and locales supported, see Internationalized name struct

Samples

Request Sample

url: https://{apigw-address}/app-portal-service/v2.0/message/enum/ringtones
method: GET

Return Sample

{
  "code": 200,
  "message": "",
  "data": {
    "ringings": [
      {
        "id": 0,
        "name": {
          "default": "No Sound",
          "en_US": "No Sound",
          "zh_CN": "无声音"
        }
      },
      {
        "id": 1,
        "name": {
          "default": "Alarm Sound",
          "en_US": "Alarm Sound",
          "zh_CN": "警报声"
        }
      }
    ]
  }
}

Java SDK Sample

public class AppPortalSdkTest{
    @Test
    public void getMessageRingtonesTest() {
        MessageRingingRequest messageColorRequest=new MessageRingingRequest();
        MessageRingingResponse response=getPoseidon().getResponse(messageColorRequest,MessageRingingResponse.class);
        System.out.println("Message Ring tones: "+JSON.toJSONString(response));
        assertNotNull(response);
    }
}