CoverShare API Guideline

• API (Application Programming Interface)
• Data format: JSON
• Encode: JSON and PHP
• Request charset: UTF-8
• Update: 2008-09-29
• Email contact: fff.fun (at) gmail

• Current API
  1. Search Album
  2. Recent Update
  3. Recent by Userid

1. Search Album
   • URL: http://www.covershare.com/api/search.php?album=keyword&artist=keyword[&track=keyword]
   • Request:
     • Album keyword (album)
     • Artist keyword (artist)
     • Tracklist keyword (track)[optional]
   • Process: First step, search in Album keyword and Artist keyword. Next step, if Album keyword and Artist keyword is empty skip to use Tracklist keyword.
   • Output:
     • Result item (result) maximum = 10 items
     • Information (info)
       • URL of Album information (url)
       • Album name (album)
       • Artist name (artist)
       • URL of Album Artwork (artwork)
   • Error message:
     • 400 Bad Request: your request is invalid
     • 404 Not Found: you're requesting an invalid resource
   • Example:
     • http://www.covershare.com/api/search.php?album=Urban Lullaby
       • Return: all album like "Urban Lullaly"
     • http://www.covershare.com/api/search.php?artist=ETC
       • Return: all album from ETC
     • http://www.covershare.com/api/search.php?album=Bring It Back&artist=ETC
       • Return: album "Brint It Back" from ETC
     • http://www.covershare.com/api/search.php?track=ดูเธอทำ
       • Return: all album have "ดูเธอทำ" in tracklist
2. Recent Update
   • URL: http://www.covershare.com/api/recent.php[?display=Display]
   • Request:
     • Display (display items)[numeric] (maximum = 10, default = 10) [optional]
   • Process: Query latest 10 album artwork are update in CoverShare.com.
   • Output:
     • ID (id)
     • URL of Album information (url)
     • Album name (album)
     • Artist name (artist)
     • URL of Album Artwork (artwork)
     • Tracklist (tracklist)
     • Update time (updatestamp)
   • Example:
     • http://www.covershare.com/api/recent.php
       • Return: recent 10 items in CoverShare.com
     • http://www.covershare.com/api/recent.php?display=5
       • Return: recent 5 items in CoverShare.com
3. Recent by Userid
   • URL: http://www.covershare.com/api/recentbyuserid.php?userid=Userid[&display=Display]
   • Request:
     • Userid (userid) [numeric]
     • Display (display items)[numeric] (maximum = 10, default = 10) [optional]
   • Process: Query latest album artwork are update by userid.
   • Output:
     • User information (user):
       • Userid (userid)
       • Nickname (usernickname)
       • URL of User information (userurl)
     • Recent by User (userrecent):
       • ID (id)
       • URL of Album information (url)
       • Album name (album)
       • Artist name (artist)
       • URL of Album Artwork (artwork)
       • Tracklist (tracklist)
       • Update time (updatestamp)
   • Error message:
     • 400 Bad Request: your request is invalid
     • 404 Not Found, user: you're requesting an invalid userid
     • 404 Not Found, recent: you're requesting an invalid resource
   • Example:
     • http://www.covershare.com/api/recentbyuserid.php?userid=1
       • Return: recent 10 items from Userid = 1
     • http://www.covershare.com/api/recentbyuserid.php?userid=1&display=5
       • Return: recent 5 items from Userid = 1

• Return to CoverShare.com homepage