licenseSong.rest
License (purchase) a song for commercial use.
| Param Name |
Req |
Type |
Description |
| trackId |
Y |
Number |
The trackId of the song you wish to license, as returned by the
getSong.rest
service.
|
| payeeFirstName |
Y |
String |
The first name of the person paying for the license.
|
| payeeLastName |
Y |
String |
The last name of the person paying for the license.
|
| payeeEmail |
Y |
String |
The e-mail address of the person paying for the license.
|
| licenseToName |
Y |
String |
The name of the person or company that the song will be licensed to.
|
| usageNotes |
Y |
String |
A short description of how the song will be used. This is typically a project or film name.
|
| optionCode0 .. optionCodeN |
Y |
Number |
The license option codes (see 'licenseOptions' element in
getSong.rest). Include one parameter for each license option (e.g., Web Video, TV Commercial, etc.),
and number them starting at zero. For example, of you are buying 3 options, then you should pass three parameters: optionCode0, optionCode1, and optionCode2.
|
| price0 .. priceN |
Y |
Number |
The prices for each of the corresponding optionCode values. Include one parameter for each license option,
and number them starting at zero. For example, of you are buying 3 options, then you should pass three parameters: price0, price1, and price2.
There must be one 'price' parameter for each 'optionCode' parameter.
|
| total |
Y |
Number |
The total dollar amount of the purchase, including decimal point. Do not include the dollar sign.
|
| unlimitedUse |
Y |
Boolean |
Set to 'true' if buying a Perpetual-Use license, 'false' if buying a Single-Use license.
|
| client |
Y |
String |
The name and version number of the client application uploading the file (e.g., "acme-client/1.0"). Note: A valid/unique client name is
required before uploading a file.
Contact Us to obtain a valid client name.
|
Try It!
|