photo-front/documentation/api/Api.markdown

Open Photo API

OpenPhoto, a photo service for the masses

---

How do I authenticate?

The Open Photo API uses OAuth1.0a 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 /hello.json Test endpoint.
2. GET /photos/list.json Get a list of the user's photos.
3. GET /photo/:id/view.json Get a user's photo.
4. POST /photo/upload.json Upload a new photo.
5. GET /tags/list.json Get a user's tags.
6. POST /tag/:id/update.json Modify meta data for a user's tag.