update

Description

Update PIC image data permanently: privacy or keywords

URL

/VERSION/image/update/ID.FORMAT

Available Format

JSON

HTTP Method

GET

Accepted Version

1

Requires

Administrator Authorization or User resource owner token authorization

Headers

Generic parameters (those must be included always)

  • access_token: (Required) access_token.
  • id: (Required)  PIC filename unique identifier.
  • keywords: (Optional) comma separated string keywords. Max 250 characters.
  • privacy: (Optional) new privacy mode value. String values allowed:
    • ‘public’: image can be retrieved by all app users and it can be viewed with a public uri without access token specified
    • ‘client’: all app users can request and view this image by specifing any app access token.
    • ‘user’: only user resource owner access token can retrieve this image.

Example

https://pic.topoos.com/1/image/update/lighthouse_7.json?privacy=client&keywords=terrain,build&access_token=7c77w8e7d-f717-81c1-34ce-902c3d4b51ca1

Reply
JSON example reply

{
    "code": 200,
    "description": "OK"
}