README 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637
  1. This is the GNU FM server, compatible with the last.fm API.
  2. To install visit http://yourserver.com/install.php
  3. As things stand you'll need the ADODB module installed.
  4. Web services API:
  5. To test the authentication API once the server is set up:
  6. 1. Navigate to /2.0/?method=auth.gettoken&api_key=01234567890123456789012345678901&api_sig=01234567890123456789012345678901
  7. (The api_key and api_sig are only checked to be 32 characters long since Last.FM shared secrets cannot be checked)
  8. 2. Copy the key that is returned by the auth.gettoken method
  9. 3. Navigate to /api/auth/?api_key=01234567890123456789012345678901&token=<copied token>
  10. (Inserting the copied token into the noted place)
  11. 4. Login as testuser/password (this user is hard-coded upon database setup)
  12. 5. Close the browser when requested
  13. 6. Navigate to /2.0/?method=auth.getsession&api_key=01234567890123456789012345678901&api_sig=01234567890123456789012345678901&token=<copied token>
  14. (Once again substituting the old copied token into the noted place)
  15. 7. The 32-byte key returned between the <key> tags in this response will be used in the Submissions protocol handshake
  16. Submissions API:
  17. The submissions API (http://www.last.fm/api/submissions) is used by clients for scrobbling tracks, authentication can either be carried out with a token from the web services API or via a token created by "md5(md5(password) + timestamp)"
  18. To test standard authentication:
  19. 1. Visit /?hs=true&p=1.2&u=testuser&t=1238855138&a=a40dfdc5aa3012c64425a5953267b232&c=tst
  20. 2. You should receive "OK" (followed by a session id, and the URL for the now playing and submissions servers).