Home
Replacing a name pronunciation file
To replace the name pronunciation file associated with a profile, send a binary audio file to the Web address defined in the audio file link returned by the Profile's entry document.
You can only replace the name pronunciation file of the user whose credentials you provided to authenticate with the server See Authenticating requests for information about how to authenticate the request. To replace the name pronunciation file for a profile...
- Get the service document for the person's profile. See Retrieving the Profiles service document.
- Get the URI of the profiles feed which is specified in the href attribute of the collection element in the service document and use it to get the profiles feed for the person.
- Find the <link rel="http://www.ibm.com/xmlns/prod/sn/pronunciation" .../> element returned in the feed. For example:
<link href="https://profiles.enterprise.acme.com/profiles/audio.do? key=b559403a-9r32-2c81-c99w-ppq8bb69442j&lastMod=1204662695516" rel="http://www.ibm.com/xmlns/prod/sn/pronunciation" type="audio" />
- Send a PUT request to the Web address specified in the href attribute.
Be sure to make the new audio file available to the application. For example, if you are writing a Java™ application, you might use a method that extends the EntityEnclosingMethod class to reference the file. Or, you might make the file available by adding it to a file system location that is HTTP addressable.
Atom API request details
Method Resource URI Input representation PUT Audio file Value of the href attribute of the <link rel="http://www.ibm.com/xmlns/prod/sn/pronunciation" .../> element in the user's profiles feed. "audio/wav" or "audio/x-wav"
Input
Provide a binary audio file in the format indicated by a Content-Type header.
Output
None. Returned HTTP Headers
- HTTP/1.1 200 OK
- Indicates that the audio file was successfully updated.
Working with pronunciation files
Related reference
Retrieving a name pronunciation file