Difference between revisions of "User:Nava Muni/n2k"

From Second Life Wiki
Jump to navigation Jump to search
(created)
 
(cleaned up the spacing)
Line 2: Line 2:


== Ver 2.0 ==
== Ver 2.0 ==
<code><pre style="font-size:1.2em"><nowiki>http://HOST/sl-n2k2.php?cmd=n2k&name=FIRST+LAST</nowiki></pre></code>
<code><pre style="font-size:1.2em"><nowiki>http://HOST/sl-n2k2.php?cmd=n2k&name=FIRST+LAST</nowiki></pre></code>


Line 10: Line 9:


=== Return ===
=== Return ===
''Note: all returned data is {{Mono|text/plain}}''
''Note: all returned data is {{Mono|text/plain}}''


* on valid data<br>{{Mono|UUID S FIRST LAST}}<br>where {{Mono|S &#8712; {0,1}}} such that<br>{{Mono|0}} indicates a resident who ''might'' no longer exist, and<br>{{Mono|1}} indicates a confirmed resident.<br>{{Mono|FIRST}} and {{Mono|LAST}} are returned in the correct (that is, user-created) case.
* on valid data<br>{{Mono|UUID S FIRST LAST}}<br>where {{Mono|S &#8712; {0,1}}} such that<br>{{Mono|0}} indicates a resident who ''might'' no longer exist, and<br>{{Mono|1}} indicates a confirmed resident.<br>{{Mono|FIRST}} and {{Mono|LAST}} are returned in the correct (that is, user-created) case.
* if no data found<br>{{Mono|00000000-0000-0000-0000-000000000000 0 - -}}
* if no data found<br>{{Mono|00000000-0000-0000-0000-000000000000 0 - -}}


=== Examples ===
=== Examples ===
<code style="font-size:1.2em"><nowiki>http://HOST/sl-n2k2.php?cmd=n2k&name=nava+muni</nowiki></code>
<code style="font-size:1.2em"><nowiki>http://HOST/sl-n2k2.php?cmd=n2k&name=nava+muni</nowiki></code>


Line 25: Line 23:


''Note the case of the resident's name in the query and in the result.''
''Note the case of the resident's name in the query and in the result.''


== Ver 1.0 ==
== Ver 1.0 ==
<code><pre style="font-size:1.2em"><nowiki>http://HOST/sl-n2k.php?do=n2k&name=FIRST+LAST</nowiki></pre></code>
<code><pre style="font-size:1.2em"><nowiki>http://HOST/sl-n2k.php?do=n2k&name=FIRST+LAST</nowiki></pre></code>


''Note: this version differs from Ver 2 only in its URL format; the returned data is identical.''
''Note: this version differs from Ver 2 only in its URL format; the returned data is identical.''

Revision as of 01:14, 12 October 2008

I created this web service because I did not like relying on an external (non-Linden Lab) source for name-to-key translations. Unlike other services that use (semi-)automatic in-world data collection, my service goes 'right to the source' and queries the Linden Lab data services. I've found that other external sources sometimes miss low-activity residents altogether. The chances of that happening with the Linden Lab services is nil.

Ver 2.0

http://HOST/sl-n2k2.php?cmd=n2k&name=FIRST+LAST

Usage

  • FIRST is the resident's first name; case-insensitive
  • LAST is the resident's last name; case-insensitive

Return

Note: all returned data is text/plain

  • on valid data
    UUID S FIRST LAST
    where S ∈ {0,1} such that
    0 indicates a resident who might no longer exist, and
    1 indicates a confirmed resident.
    FIRST and LAST are returned in the correct (that is, user-created) case.
  • if no data found
    00000000-0000-0000-0000-000000000000 0 - -

Examples

http://HOST/sl-n2k2.php?cmd=n2k&name=nava+muni

yields

74d815e8-183f-420b-8e44-ed4e288e2d3d 1 Nava Muni

Note the case of the resident's name in the query and in the result.

Ver 1.0

http://HOST/sl-n2k.php?do=n2k&name=FIRST+LAST

Note: this version differs from Ver 2 only in its URL format; the returned data is identical.