Difference between revisions of "Snapshot API"

Revision as of 00:28, 17 January 2010

Second Life APIs

Registration API

Map API

Marketplace API for Viewers

Unofficial APIs

Getting Started

What is the Snapshot API?

The Second Life Snapshot API enables you to parse information from Snapshot emails sent from Second Life for:

Blogging
Social Networking
Image Libraries

Where is the Snapshot API used?

There are many websites that already use this information. Some of them are as follows:

Headers

Email messages have headers that provide metadata about the message itself. Most of this information is hidden from the person reading an email message. You can use some of this information to verify that the snapshot came from a Linden Lab server.

The following headers are available.

Parameter	Data type	Description
X-Originating-IP	string	IP of simulator. [216.82.41.11]
Subject	string	Subject of message
Sender	string	email address of www-data account on simulator. "www-data" <www-data@sim8938.agni.lindenlab.com>
From	string	Combination of address and name. Note: name is not always avatar name.
Date	date	Date of snapshot in Pacific timezone.

Details

The HTML content will contain details of the snapshot in a comment tag:

<!-- BEGIN POSTCARD DETAILS
agent_id=c4822e40-f763-4eec-bba3-e4bf842a074a
username="Dedric Mauriac"
region_id=714a15be-8511-4842-a8c1-38c1f54f3c58
sim_name="Applewood"
global_x=260282
global_y=235143
local_x=186
local_y=135
local_z=56
END POSTCARD DETAILS -->

Parameter	Data type	Description
agent_id	key	The UUID of the avatar that sent the message.
username	string	Quoted name of the avatar who sent the message.
region_id	key	The UUID of the region that the avatar was standing when the snapshot was taken.
sim_name	string	Quoted name of the region that the avatar was standing when the snapshot was taken.
global_x	integer	The grids horizontal location of where the avatar was standing when the snapshot was taken.
global_y	integer	The grids vertical location of where the avatar was standing when the snapshot was taken.
local_x	integer	The regions horizontal location of where the avatar was standing when the snapshot was taken.
local_y	integer	The regions vertical location of where the avatar was standing when the snapshot was taken.

Body

The body of the post card itself is identified with comments as well.

<!-- BEGIN POSTCARD BODY -->
test message
<!-- END POSTCARD BODY -->

Snapshot

The snapshot is a JPEG image. Postcards have two images, including a logo. The snapshot file name is always called "secondlife-postcard.jpg".

@@ Line 6: / Line 6: @@
 === What is the Snapshot API? ===
-content
+The Second Life Snapshot API enables you to parse information from Snapshot emails sent from Second Life for:
+* Blogging
+* Social Networking
+* Image Libraries
-=== Paging ===
+=== Where is the Snapshot API used? ===
+There are many websites that already use this information. Some of them are as follows:
+* [http://www.sluniverse.com/pics SL Universe]
+* [http://bloghud.com/ blogHUD]
+* [http://mixoom.com/ Mixoom]
 === Headers ===
@@ Line 56: / Line 63: @@
   local_z=56
   END POSTCARD DETAILS -->
+{| style="border:1px solid #A3B1BF; text-align:left; background:#f5faff"
+|-
+|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Parameter'''
+|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Data type'''
+|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Description'''
+|-
+|agent_id
+|key
+|The UUID of the avatar that sent the message.
+|-
+|username
+|string
+|Quoted name of the avatar who sent the message.
+|-
+|region_id
+|key
+|The UUID of the region that the avatar was standing when the snapshot was taken.
+|-
+|sim_name
+|string
+|Quoted name of the region that the avatar was standing when the snapshot was taken.
+|-
+|global_x
+|integer
+|The grids horizontal location of where the avatar was standing when the snapshot was taken.
+|-
+|global_y
+|integer
+|The grids vertical location of where the avatar was standing when the snapshot was taken.
+|-
+|local_x
+|integer
+|The regions horizontal location of where the avatar was standing when the snapshot was taken.
+|-
+|local_y
+|integer
+|The regions vertical location of where the avatar was standing when the snapshot was taken.
+|}
 === Body ===