AlbumExposure API

Albums


Endpoints:


Get albums

GET /api/albums

Lists the albums in your account

[
  {
    "id": "1",
    "sent_view_reminder_at": null,
    "client_email": "client@example.com",
    "starts_on": "left",
    "email": "",
    "notify_client_of_comments": false,
    "viewed_at": "2011/12/06 20:11:13 +0000",
    "first_viewed_at": "2012/03/13 18:47:34 +0000",
    "default": "book",
    "width": 1000,
    "permalink": "client-album",
    "allow_client_notifications": true,
    "name": "Client Album",
    "embed": true,
    "sent_approve_reminder_at": null,
    "snapknot": false,
    "password": "another",
    "height": 393,
    "archived": false,
    "approved_at": "2010/07/13 17:40:44 +0100",
    "sent_link_at": null,
    "print_status": null,
    "created_on": "2010/02/12",
    "song_id": null,
    "shadow": false,
    "language": "de_DE"
  }
  ...
]

Get an album

GET /api/album/1

Response
Status: 200 OK


Create an album

POST /api/albums

{
  "name": "Client Album",
  "password": "mypassword",
  "default": "slideshow",
  "shadow": "false",
  "song-id": "176"
}
Response
Status: 201 Created


Update an album

PATCH /albums/1

{
  "name": "Client Album",
  "password": "mypassword",
  "default": "slideshow",
  "shadow": "false",
  "song-id": "176"
}
Response
Status: 200 OK


POST /albums/1/email

Emails the album link to the recipient.

The 'to' param is only required when there isn't already an email attached to the album. 

{
  "to": "client@example.com"
}
Response
Status: 204 No Content