Magazinify API

one comment

Updated on: Jan 4, 2011

Magazinify now allows third party application developers to add URLs to user’s account.

Basics:
We currently support basic HTTP calls, which means URL’s should be accessed along with their respective parameters and plain text response will be returned.  The status will also be reflected via HTTP status code.

Dictionary:
Username: The email address used by user for receiving emails.
Key: The API Key provided on user’s dashboard after logging in.
AppId: Id of your registered application. Application can be registered at http://magazinify.com/developer/register
AppSecret: Your application secret key.
Authentication API:
It is used to validate the user’s credential. This can be used if you want to check credentials without adding an URL. You do not need an registered application to access this api.
URL: http://magazinify.com/api/authenticate
Accessible via POST method.
Parameters:

  • username
  • key

Response status codes:

  • 200: OK
  • 400: Bad request. Missing username/key.
  • 401: Invalid username or key.
  • 500: Some error occurred while processing the request.

Adding URLs API:
It can be used to add URLs to the Magazinify account. Authentication API need NOT be called every time a URL has to be added. This API is only accessible to authenticated applications.
URL: http://magazinify.com/api/add
Accessible via POST method.
Parameters:

  • username
  • key
  • url
  • appid
  • appsecret

Response status codes:

  • 200: OK. Request processed, but the URL has already been added by the user previously. No new entry created.
  • 201: The URL has been successfully added to the user’s Magazinify account.
  • 400: Bad request. Missing username/key/url/appid/appsecret.
  • 401: User+Key Combination or AppId+AppSecret Combination error.
  • 403: Revoked access to application.
  • 500: Some error occurred while processing the request.

Cheers!
Keep Magazinifying 🙂

Written by Aman Kumar Jain

January 2nd, 2011 at 5:48 pm

Posted in magazinify