Retrieve a name pronunciation file
To retrieve the name pronunciation file available from a person's profile, use the audio file link returned in the entry document.You can retrieve name pronunciation file for any person in your organization. You will still have to authenticate when you make the request if the server is set up to force all traffic to use SSL. See Authenticating requests for information about how to authenticate the request.
To retrieve a name pronunciation file from a profile...
- Get the service document for the person's profile. See Retrieve 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.example.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 GET request to the web address specified in the href attribute.
Table 1. Atom API request details
Method Resource URI Output representation GET 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
None.
Output
A binary image fileReturned HTTP Headers
HTTP/1.1 200 OK
Indicates that the request succeeded.
Content-Type
Indicates format of the response to a GET request.
Content-Length
Indicates the length of the response to a GET request.
Parent topic
Work with pronunciation filesRelated reference
Replacing a name pronunciation file
});