Retrieve a name pronunciation fileTo 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"
OutputA binary image file
Returned HTTP Headers
HTTP/1.1 200 OK
Indicates that the request succeeded.
Indicates format of the response to a GET request.
Indicates the length of the response to a GET request.
Parent topicWork with pronunciation files
Replacing a name pronunciation file