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...

  1. Get the service document for the person's profile. See Retrieve the Profiles service document.

  2. 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.

  3. 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" /> 

  4. 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 file

Returned HTTP Headers

HTTP/1.1 200 OK

Content-Type

Content-Length


Parent topic

Work with pronunciation files

Related reference
Replacing a name pronunciation file


   

 

});