Difference between revisions of "User:Nava Muni/n2k"
Jump to navigation
Jump to search
(created) |
(added forgotten feature of 'multiple names' for ver 2) |
||
(6 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
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. | <div style="float:left;padding-right:2em">__TOC__</div> | ||
<div>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 techniques, 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 data services is nil.<br><br>If you'd like to use this API, please contact [[User:Nava Muni|Nava Muni]] for host information.</div><div style="clear:left"></div> | |||
<div id="box"> | |||
== Ver 2.0 == | == Ver 2.0 == | ||
<div style="padding:0.5em"> | |||
<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[,FIRST+LAST...]</nowiki></pre></code> | ||
=== Usage === | === Usage === | ||
* {{Mono|FIRST}} is the resident's first name; case-insensitive | * {{Mono|FIRST}} is the resident's first name; case-insensitive | ||
* {{Mono|LAST}} is the resident's last name; case-insensitive | * {{Mono|LAST}} is the resident's last name; case-insensitive | ||
You can specify any number of names; separate each by a comma. | |||
=== 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 ∈ {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 ∈ {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 - -}} | ||
* will return one line per each avatar named in the query | |||
=== 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 30: | ||
''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.'' | ||
</div></div> | |||
<div id="box"> | |||
== Ver 1.0 == | == Ver 1.0 == | ||
<div style="padding:0.5em"> | |||
<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.'' | ||
</div></div> |
Latest revision as of 06:21, 13 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 techniques, 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 data services is nil.
If you'd like to use this API, please contact Nava Muni for host information.
If you'd like to use this API, please contact Nava Muni for host information.
Ver 2.0
http://HOST/sl-n2k2.php?cmd=n2k&name=FIRST+LAST[,FIRST+LAST...]
Usage
- FIRST is the resident's first name; case-insensitive
- LAST is the resident's last name; case-insensitive
You can specify any number of names; separate each by a comma.
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 - -
- will return one line per each avatar named in the query
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.