API Documentation

The Momentile API

Welcome to our humble API. If you are thinking of writing an app (iOS, Android, or otherwise), then you’re in the right place.

We whole-heartedly encourge the development of 3rd-party apps. However, our API is in a super-beta state right now, so in order to get access to it (I.E. become an authorized OAuth consumer) you’ll have to contact us directly at support at momentile dot net so you can tell us why you would like API access.

API Info

Our API uses 3-legged OAuth to provide secure access to user data, it is RESTful and lightweight. It supports JSON (default), XML, YAML, and Pickle output formats.

UserInfo:

Description:
Accepted methods: GET, POST
method read():
method create():

Creates a new Momentile user. Only allowed to be used by official momentile apps.

Stalkee:

Description:
URL: /api/stalkees/

Returns the user's stalkees along with info about the latest tile uploaded by each stalkee.
Accepted methods: GET
method read():

Returns a list of user's the authorized user is stalking.

Everyone:

Description:
URL: /api/everyone/

Returns a list of 30 of the most recent tiles uploaded. Paging is not yet supported.
Accepted methods: GET
method read():

Self-explanatory.

CurrentTile:

Description:
URL: /api/current_tile/

Retrieve or update the user's current 'Tile.
Accepted methods: GET, POST
method read():

Returns basic information about the user's current 'Tile.

method create():

Creates or updates the user's current 'Tile. Remember, a user can only have 1 current 'Tile for each 24 hour period. E.g. Uploading replaces the current tile for the current 24 hour window.

Parameters:

  • image: The image data of the photo to post.
  • message: The message to attach to the photo.
  • geo_lat, geo_long: Optional

StalkeeWithLocation:

Description:
URL: /api/stalkees/

Returns the user's stalkees along with info about the latest tile uploaded by each stalkee.
Accepted methods: GET
method read():

Returns a list of user's the authorized user is stalking.

EveryoneWithLocation:

Description:
URL: /api/everyone/

Returns a list of 30 of the most recent tiles uploaded. Paging is not yet supported.
Accepted methods: GET
method read():

Self-explanatory.

EnhanceFilter:

Description:
Accepted methods: GET
method read():