api.ringtone.add
Creates a new ringtone.
Note: This method requires a
multipart form post.
Arguments
- api_key
- Your API application key. See here for more details on api_key.
- name
- ringtone name
- profile_id (optional)
- only used when share_mode is 'public'
profile_id value return from api.profile.add
the primary profile for the account is used if none is specified
- start (optional)
- start time in milliseconds
- stop (optional)
- stop time in milliseconds
- price (optional)
- value specified in cents - defaults to free
allowed prices: 0, 99, 125, 150, 175, 199, 225, 249, 299
- genre (optional)
- numeric genre id
| Genre |
ID |
| None |
0 |
| Pop / Rock |
1 |
| Hip Hop |
2 |
| Country |
3 |
| Latin |
4 |
| Christian / Gospel |
5 |
| Dance / Electronic |
6 |
| Classical / Jazz |
7 |
| Comedy |
8 |
| Other |
9 |
- api_sig
- Secure signature of the api parameters excluding file. See here for details on api_sig.
- file
- binary audio file (not included in api_sig)
Example Response
The response format is a simple XML block.
Success Response
<?xml version="1.0" encoding="utf-8" ?>
<response status="ok">
<id>c-123456</id>
</response>
Error Response
<?xml version="1.0" encoding="utf-8" ?>
<response status="fail">
<code>[error-code]</code>
<msg>[error-message]</msg>
</response>