Difference between revisions of "YTMND:API:Interfaces"

From YTMND
Jump to: navigation, search
 
Line 2: Line 2:
  
 
==Users==
 
==Users==
 +
 +
===Example request===
 +
http://api.ytmnd.com/user/max
 +
 +
===Example responses===
 +
 +
====XML====
 +
<?xml version="1.0" encoding="ISO-8859-1"?>
 +
<ytmnd_response timestamp="1192340109" request_type="user_lookup" extended_request="basic" returned_results="1">
 +
  <users>
 +
    <user user_id="1" signup_date="1081312566" user_name="max" />
 +
  </users>
 +
</ytmnd_response>
 +
 +
====JSON====
 +
{
 +
  "timestamp":1192340298,
 +
  "request_type":"user_lookup",
 +
  "extended_request":"basic",
 +
  "returned_results":1,
 +
  "users":
 +
  {
 +
  "1":
 +
  {
 +
    "signup_date":"1081312566",
 +
    "user_name":"max",
 +
    "user_id":"1"
 +
  }
 +
  }
 +
}
 +
 +
====PHP====
 +
a:5:
 +
{
 +
  s:9:"timestamp";
 +
  i:1192340492;
 +
  s:12:"request_type";
 +
  s:11:"user_lookup";
 +
  s:16:"extended_request";
 +
  s:5:"basic";
 +
  s:16:"returned_results";
 +
  i:1;
 +
  s:5:"users";
 +
  a:1:
 +
  {
 +
  i:1;
 +
  a:3:
 +
  {
 +
    s:11:"signup_date";
 +
    s:10:"1081312566";
 +
    s:9:"user_name";
 +
    s:3:"max";
 +
    s:7:"user_id";
 +
    s:1:"1";
 +
  }
 +
  }
 +
}
 +
 +
===Endpoints===
 +
GET /user/{user name}
 +
*Named user.
 +
GET /user/{user name}/all_sites
 +
*All of named user's sites.
 +
GET /user/{user name}/recent_sites
 +
*Named user's 5 most recent sites.

Revision as of 23:47, October 13, 2007

Sites

Users

Example request

http://api.ytmnd.com/user/max

Example responses

XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<ytmnd_response timestamp="1192340109" request_type="user_lookup" extended_request="basic" returned_results="1">
  <users>
    <user user_id="1" signup_date="1081312566" user_name="max" />
  </users>
</ytmnd_response>

JSON

{
 "timestamp":1192340298,
 "request_type":"user_lookup",
 "extended_request":"basic",
 "returned_results":1,
 "users":
 {
  "1":
  {
   "signup_date":"1081312566",
   "user_name":"max",
   "user_id":"1"
  }
 }
}

PHP

a:5:
{
 s:9:"timestamp";
 i:1192340492;
 s:12:"request_type";
 s:11:"user_lookup";
 s:16:"extended_request";
 s:5:"basic";
 s:16:"returned_results";
 i:1;
 s:5:"users";
 a:1:
 {
  i:1;
  a:3:
  {
   s:11:"signup_date";
   s:10:"1081312566";
   s:9:"user_name";
   s:3:"max";
   s:7:"user_id";
   s:1:"1";
  }
 }
}

Endpoints

GET /user/{user name}

  • Named user.

GET /user/{user name}/all_sites

  • All of named user's sites.

GET /user/{user name}/recent_sites

  • Named user's 5 most recent sites.