GetDisplayNames

From Second Life Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

GetDisplayNames Capability

Request

Basic syntax for getting display name data structures for a given uuid or slid:

GET getCapability("GetDisplayNames") + "/?ids=<uuid>" [ + "&username=<slid> ... ]
GET getCapability("GetDisplayNames") + "/?username=<slid>" [ + "&username=<slid> ... ]

You can mix and match uuids and slids in a single query, too:

GET getCapability("GetDisplayNames") + "/?ids=<uuid>&username=<slid>" ...

Please limit request length to reasonable lengths, otherwise truncation may occur in the middle of a query parameter.

Response

GET getCapability("GetDisplayNames") + "/?username=stone.linden"

<?xml version="1.0"?>
<llsd>
 <map>
   <key>agents</key>
   <array>
     <map>
       <key>username</key>
       <string>stone.linden</string>
       <key>display_name</key>
       <string>Stone Linden</string>
       <key>display_name_next_update</key>
       <date>1970-01-01T00:00:00Z</date>
       <key>legacy_first_name</key>
       <string>Stone</string>
       <key>legacy_last_name</key>
       <string>Linden</string>
       <key>id</key>
       <uuid>c06c4bd0-e8e6-4712-9918-c4d8443dd20a</uuid>
       <key>is_display_name_default</key>
       <boolean>true</boolean>
     </map>
   </array>

   <key>bad_ids</key>
   <array>
     <string>bad-uuid-here</string>
   </array>

   <key>bad_usernames</key>
   <array>
     <string>bad-usernames-here</string>
   </array>
 </map>
</llsd>