Albums

https://itunes.apple.com/us/app/albums-private-photo-sharing/id906530752?mt=8

Base URI

https://fifth-glazing-578.appspot.com/api

Authenticate

GET /authenticate

Create album

POST /album

List all albums (deprecated)

GET /album

Get album

GET /album/{id}

Init upload

PUT /album/{albumId}/upload

Remove photo from Album

DELETE /photo/{photoId}

Upload Photo (Deprecated)

POST /

Find friends with installed App

GET /invite/friends/{provider}/oauthToken/{oauthToken}

Leave album keep photos

DELETE /album/{albumId}

Leave album remove photos

DELETE /album/{albumId}/photos

Hide photo

POST /album/{albumId}/hide/{photoId}

Logout

POST /logout

List all albums (no photos)

GET /album/nophotos

Get shared album url

GET /album/{albumId}/sharedUrl

Get shared album

GET /album/shared/{sharedToken}

Get news

GET /news

Get invite message

GET /invite/message/{token}

Update user info

POST /user/update

Rename method

PUT /album/{albumId}/name

Mute Unmute album

PUT /album/{albumId}/mute

Upload Photo

POST /

List Photos

GET /album/{albumId}/photos/{start}/number/{number}

Get Album changes

GET /album/{albumId}/changes

List Albums

GET /album/list

Invite Users

POST /invite

Invite By Phone

GET /invite/phone

POST /invite

Request body

InviteRequest

Responses

200 OK

Body

Array of InviteResponse

Example 1

POST https://fifth-glazing-578.appspot.com/api/invite HTTP/1.1 

Content-Type: application/json

{
    "users": [
        {
            "externalId": "1231231231123123",
            "authProvider": "Facebook"
        }
    ],
    "albumId": 123
}

HTTP/1.1 200 OK 

Content-Type: application/json

[
    {
        "inviteId": 123,
        "albumName": "Test Album",
        "albumId": 123,
        "userId": 1123,
        "invitationDate": 1,
        "invitator": {
            "id": 1123,
            "firstName": "",
            "lastName": ""
        },
        "status": "PENDING,ACCEPTED,DECLINED"
    }
]

GET /invite/phone

Request body

InviteByPhoneRequest

Responses

200 OK

Body

InviteResponse

Send invite

GET /test/invite/{inviteId}/type/{inviteType}/user/{userId}/album/{albumId}

Path variables

inviteId

string required

inviteType

string required

ACCEPT_INVITE, INVITE, PHOTO

userId

string required

albumId

string required

Responses

200 OK

Register iOS device

POST /device/ios/register

Register Android device

POST /device/android/register

POST /device/ios/register

Request body

device token byte array

Responses

200 OK

POST /device/android/register

Request body

registerId string

Responses

200 OK

Post comment

POST /comments/photo/{photoId}

Get comments

GET /comments/photo/{photoId}

Delete comment

DELETE /comments/photo/{photoId}/comment/{commentId}

POST /comments/photo/{photoId}

Path variables

photoId

string required

Request body

string

Examples

"nice photo"

Responses

200 OK

Body

Comment

200 OK

Verify phone (with SMS)

POST /register/phone/verify

Register phone

POST /register/phone

Verify phone (with SMS and deep link, iOS only)

POST /phone/verify/deeplink

POST /register/phone/verify

The server will send SMS

Request body

Object

region

string

Example:

US

number

string

Example:

2026296756

secret

string

Example:

asdvasdvasdvasdvasdvasdvasdv

Responses

200 OK

Body

Object

verifyToken

string

Example:

123123123123112312

POST /register/phone

Request body

Object

code

string

Example:

4455

verifyToken

string

Example:

asdfasdfasdfasdfasdf

firstName

string

lastName

string

Responses

200 OK

Body

Object

userId

number

Example:

123123

accessToken

string

Example:

asdcasdcasdcasdc

phone

string

Example:

+12026296755

firstName

string

lastName

string

404 Not found

combination of code and token not found

POST /phone/verify/deeplink

Request body

Object

region

string

Example:

US

number

Example:

2026296756

secret

string

Example:

asdvasdvasdvasdvasdvasdvasdv

locle

string

Example:

ru

appScheme

string

Example:

albums

Responses

200 OK

Body

Object

code

number

Example:

123123

token

string

Example:

token

Init batch upload

POST /album/{albumId}/batch

Get new batch part upload url

GET /album/{albumId}/batch/{batchId}

Get new High Res photo upload URL

POST /album/highResUploadUrls

Upload batch part

POST /uploadBatchPartUrl

Upload high resolution photo

POST /uploadHighResUrl

POST /album/{albumId}/batch

Path variables

albumId

string optional

Request body

Array of BatchPart

Responses

200 OK

Body

Object

batchId

number

Example:

123

parts

PartUrl

GET /album/{albumId}/batch/{batchId}

This method is called to get new upload url for batch part, in case of batch part uploading failure, for intance.

Path variables

albumId

string optional

batchId

string optional

Request body

BatchPart

Responses

200 OK

Body

PartUrl

POST /album/highResUploadUrls

Request body

list of photo ids

Array of number

Responses

200 OK

Body

Array of HighResUrlUpdate

POST /uploadBatchPartUrl

When you upload batch part you must fill headers with complete Batch object and index of batch part witnin this object

Request headers

partIndex

string optional

Request body

Multiart filled with

“batch” - json with complete batch object
low res images, Content-Type must be specified: image/jpeg, image/png

string required

Facebook token

Example:

testtoken

provider

string required

Example:

Facebook

Responses

200 OK

Body

Object

userId

number

Example:

2

accessToken

string

Example:

029b13c1-ef76-4b37-8dbe-a17e713d29a2

POST /album

Creates new album for the user

Request body

Object

name

string

Example:

Album Name

200 OK

Body

Array of UploadResponseInfo

DELETE /photo/{photoId}

Path variables

photoId

string required

Responses

200 OK

POST /

ATTENTION! Base URL is different for this method!!! Use uploadUrl returned by init method

HEADERS
Content-Type: multipart/form-data
service-meta-album: albumId
service-meta-user: userId
servce-meta-asset: file url on deivce
service-meta-width: image width
service-meta-height: image height
service-meta-latitude: not required
service-meta-longitude: not required service-meta-client-upload-date: not required service-meta-date: photo creation time in millis since 1970

Responses

200 OK

GET /invite/friends/{provider}/oauthToken/{oauthToken}

Path variables

provider

string required

Facebook

oauthToken

string required

Responses

200 OK

Body

Array of AppUser

DELETE /album/{albumId}

Leave album and keep photos

Path variables

albumId

string required

Responses

200 OK

DELETE /album/{albumId}/photos

Path variables

albumId

GET /news

Responses

200 OK

Body

Array of NewsRecord

GET /invite/message/{token}

token is passed to the web page

http://demessify.net/viewer.html#/album/invite/bb7cef66-ecb9-4c7e-b535-30ee91e7e0d6

Path variables

token

string required

Responses

200 OK

Body

Object

byUser

Object

firstName

string

Example:

Some test

lastName

string

Example:

Test Last

albumName

string

Example:

Test

photos

string

Example:

https://lh5.ggpht.com/5L6wzRjPgL-5z3i9tFK-2hBLabq6nLf5FaX_ziXpYwN7snK2bai--Tf2JY70LKxWPgaGMRM0H2dNMRZ0L9ehAo5bJedo=s640

POST /user/update

Request body

Object

firstName

string

Example:

John

lastName

string

Example:

Doe

Responses

200 OK

Body

Object

userId

number

Example:

123123

accessToken

string

Example:

asdcasdcasdcasdc

phone

string

Example:

+12026296755

firstName

unknown

lastName

unknown

PUT /album/{albumId}/name

Path variables

albumId

string required

Request body

Object

name

string

Example:

New album name

Responses

200 OK

PUT /album/{albumId}/mute

Path variables

albumId

string required

Request body

Object

muted

boolean

Example:

true

Responses

200 OK

POST /

ATTENTION! Base URL is different for this method!!! Use uploadUrl returned by init method

HEADERS
Content-Type: multipart/form-data
service-meta-album: albumId
service-meta-user: userId
servce-meta-asset: file url on deivce
service-meta-width: image width
service-meta-height: image height
service-meta-latitude: not required
service-meta-longitude: not required service-meta-client-upload-date: not required service-meta-date: photo creation time in millis since 1970

Responses

200 OK

GET /album/{albumId}/photos/{start}/number/{number}

Path variables

albumId

number optional

start

number optional

offset index

number

number optional

number of photos to return

Responses

200 OK

Body

Array of Photo

Example 1

GET https://fifth-glazing-578.appspot.com/api/album/1/photos/2/number/-17 HTTP/1.1 

HTTP/1.1 200 OK 

Content-Type: application/json

[
    {
        "id": 16,
        "assetURI": "putin.jpg",
        "uploadDate": 1402266704000,
        "creationDate": 1402266700000,
        "contentType": "image/jpeg",
        "size": 148161,
        "url": "http://lh5.ggpht.com/2FUgiX4yZoG_QTO1QDbKwSe-GDt2kyPIned0a62iHW7HgT2Gre7n7fM9XQIczmXVV-ef3H0dHcKB0KMhT9BXM7YuyYaJr34",
        "thumbnails": [
            {
                "type": "WIDTH_208, WIDTH_640, WIDTH_960",
                "url": "http://lh5.ggpht.com/2FUgiX4yZoG_QTO1QDbKwSe-GDt2kyPIned0a62iHW7HgT2Gre7n7fM9XQIczmXVV-ef3H0dHcKB0KMhT9BXM7YuyYaJr34=s208"
            }
        ],
        "width": 1,
        "height": 1,
        "owner": {
            "id": 123,
            "firstName": "Valdimir",
            "lastName": "Putin",
            "externalId": "",
            "authProvider": "",
            "creationDate": 1405358472000
        },
        "lowResUrl": ""
    }
]

GET /album/{albumId}/changes

Path variables

albumId

string optional

Request headers

If-Modified-Since

number required

Miliseconds since 1970

Responses

200 OK

Body

Array

Object

removed

Photo

highResUpdate

Photo

added

Photo

GET /album/list

Returns a list of user albums including album covers

Responses

200 OK

Body

Array of Album

Object

id

number

Example:

74

name

string

Example:

тестовый альбом

photos

Array of Photo

albumUsers

Array of AlbumUser

owner

User

creationDate

number

Example:

1406160072000

newContentDate

number

Example:

1

modificationDate

number

Example:

1

muted

boolean

muted is not returned with some methods

Example:

false

Methods: Create album Get album Get shared album List Albums List all albums (deprecated)

Object

inviteId

number

Example:

123

albumName

string

Example:

Test Album

albumId

number

Example:

123

userId

number

Example:

1123

invitationDate

number

Example:

1

invitator

Object

id

number

Example:

1123

firstName

string

lastName

string

status

string

Example:

PENDING,ACCEPTED,DECLINED

Methods: Invite By Phone Invite Users

Object

id

number

Example:

1

firstName

string

lastName

string

Object

users

Array

Object

externalId

string

Example:

1231231231123123

authProvider

string

Example:

Facebook

albumId

number

Example:

123

Methods: Invite Users

Object

id

number

Example:

16

assetURI

string

Example:

putin.jpg

uploadDate

number

Example:

1402266704000

creationDate

number

Example:

1402266700000

contentType

string

Example:

image/jpeg

size

number

Example:

148161

url

string

Example:

http://lh5.ggpht.com/2FUgiX4yZoG_QTO1QDbKwSe-GDt2kyPIned0a62iHW7HgT2Gre7n7fM9XQIczmXVV-ef3H0dHcKB0KMhT9BXM7YuyYaJr34

thumbnails

Array of Thumbnail

width

number

Example:

1

height

number

Example:

1

owner

User

lowResUrl

string

Methods: Get Album changes List Photos Upload batch part Upload high resolution photo

Types: Album AlbumNoPhotos

Object

id

number

Example:

123

firstName

string

Example:

Valdimir

lastName

string

Example:

Putin

externalId

string

302969733218156

Methods: Find friends with installed App

Object

assetURI

string

Example:

device_image_file_uri

Methods: Init upload

Object

assetURI

string

Example:

device image url

uploadUrl

string

Example:

google cloud upload url

Methods: Init upload

Object

type

string

Example:

WIDTH_208, WIDTH_640, WIDTH_960

url

string

Example:

http://lh5.ggpht.com/2FUgiX4yZoG_QTO1QDbKwSe-GDt2kyPIned0a62iHW7HgT2Gre7n7fM9XQIczmXVV-ef3H0dHcKB0KMhT9BXM7YuyYaJr34=s208

Types: Photo

Object

id

number

Example:

123

firstName

string

Example:

Valdimir

lastName

string

Example:

Putin

externalId

string

302969733218156

authProvider

string

Facebook

creationDate

number

Example:

1405358472000

Types: Album AlbumUser Comment NewsRecord Photo

Object

user

User

Types: Album

Object

id

number

Example:

74

name

string

Example:

тестовый альбом

albumUsers

Array

Object

user

Object

id

number

Example:

123

firstName

string

Example:

Valdimir

lastName

string

Example:

Putin

externalId

unknown

authProvider

unknown

creationDate

number

Example:

1405358472000

owner

Object

id

number

Example:

123

firstName

string

Example:

Valdimir

lastName

string

Example:

Putin

externalId

unknown

authProvider

unknown

creationDate

number

Example:

1405358472000

creationDate

number

Example:

1406160072000

photosNumber

number

Example:

1

cover

Photo

Methods: List all albums (no photos)

Object

id

number

Example:

1

text

string

user

User

photoId

number

Example:

1

date

number

Example:

1

Methods: Get comments Post comment

Object

id

number

Example:

123

type

string

PHOTO, COMMENT, JOIN, LEAVE,

Example:

albumName

string

Example:

Trip to Miami

date

number

Example:

12341234123412340000

user

User

payload

string

Example:

{ "photoId" : 123, "thumbnail" : "http://123.jpg", "thumbnail960" :"http://123.jpg", "firstName" : "asdvasd", "lastName" : "asdfasdf", "ownerId" : 123} { "commentId": 123, "body" : "comment text"}

albumId

string

Methods: Get news

Object

phones

Array of string

Example:

+12026293344

albumId

number

Example:

123

locale

string

Example:

US, RU

Methods: Invite By Phone

Object

assetURI

string

Example:

putin.jpg

creationDate

number

Example:

1402266700000

width

number

original photo width

Example:

640

height

number

original photo height

Example:

480

latitude

number

Example:

34.123123123

longitude

number

Example:

35.1234123

comment

string

Example:

bla bla bla

Types: BatchPart

Object

items

Array of BatchItem

Methods: Get new batch part upload url Init batch upload

Types: Batch

Object

batchPartUrl

string

Example:

http://batchpart_upload_url

itemsHighResUrls

Array of string

Example:

{ "http://high_res_image1_upload_url", "http://high_res_image1_upload_url" }

Methods: Get new batch part upload url Init batch upload

Object

batchId

number

userId

number

albumId

number

parts

Array of BatchPart

Object

photoId

number

uploadUrl

string nullable

received

boolean nullable

Methods: Get new High Res photo upload URL