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);
    }
}