photo-front/documentation/api
2011-08-20 15:05:43 -07:00
..
Authentication.markdown Adding documentation directory and initial API docs. 2011-06-06 12:20:43 -07:00
Envelope.markdown More work on the documentation and adding TOC. 2011-07-19 11:42:57 -07:00
GetPhoto.markdown Documenting photo generation and returnSizes. 2011-08-18 01:15:35 -07:00
GetPhotos.markdown Fixed curl and php examples for GET photos API. 2011-08-20 15:05:43 -07:00
GetTags.markdown Adding documentation for GET Tags API. 2011-08-19 17:33:32 -07:00
PostPhotoUpload.markdown Documenting photo generation and returnSizes. 2011-08-18 01:15:35 -07:00
Readme.markdown Adding documentation for GET Tags API. 2011-08-19 17:33:32 -07:00

Open Photo API

OpenPhoto, a photo service for the masses


How do I authenticate?

The Open Photo API uses OAuth2 for authentication. See the complete guide on authentication for details.

NOTE: OAuth2 isn't yet enabled.

What's the response format?

Every API endpoint returns a JSON response in a standard envelope.

{
  message: "A string describing the response",
  code: 200,
  result: {
    foo: "bar"
  }
}

API Endpoints

  1. GET /photos.json Get a list of the user's photos.
  2. GET /photo/:id.json Get a user's photo.
  3. POST /photo/upload.json Upload a new photo.
  4. GET /tags.json Get a user's tags.
  5. POST /tag/:id.json Modify meta data for a user's tag.