GetDisplayNames

From Second Life Wiki
Jump to navigation Jump to search

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>