Documentation

Installation: Ubuntu and Apache; OSX and Macports; AWS EC2 using an AMI; SUSE and Apache
API FAQs: General FAQs; Authenticating with OAuth 1.0a; How photos are generated; How to get specific photo sizes
Test APIs: GET /hello.json
Action APIs: POST /action/:id/create.json; POST /action/:id/delete.json
Activity APIs: GET /activities/list.json
Photo APIs: POST /photo/:id/delete.json; POST /photo/:id/update.json; GET /photos/list.json; GET /photo/:id/view.json; GET /photo/:id/nextprevious.json; POST /photo/upload.json
Tag APIs: GET /tags/list.json; POST /tag/:id/create.json; GET /tags/:id/update.json
Group APIs: GET /group/:id/view.json; GET /groups/list.json; POST /group/:id/create.json; POST /group/:id/delete.json; GET /groups/:id/update.json
Webhook APIs: POST /webhook/subscribe; GET /webhook/:id/view.json; POST /webhook/:id/delete.json

Update Tag

Purpose
Endpoint
Parameters
Examples
- Command line
- PHP
Response
- Sample

Purpose of the update Tag API

Use this API to update a tag.

Endpoint

Authentication: required

POST /tag/:id/update.json

Parameters

count (optional), Number of photos which contain this tag
email (optional), An email address that corresponds to this tag
latitude (optional), i.e. 34.76 - A decimal representation of latitude.
longitude (optional), i.e. -87.45 - A decimal representation of longitude.

Examples

Command Line (using openphoto-php)

./openphoto -p -X POST -h current.openphoto.me -e /tag/sunnyvale/update.json -F 'count=10'

PHP (using openphoto-php)

$client = new OpenPhotoOAuth($host, $consumerKey, $consumerSecret, $oauthToken, $oauthTokenSecret);
$response = $client->post("/tag/sunnyvale/update.json", array('count' => 10));

Response

The response is in a standard response envelope.

message, A string describing the result. Don't use this for anything but reading.
code, 200 on success
result, A Tag object or FALSE on error

Sample

{
  "message":"",
  "code":200,
  "result":
  {
    "id": "mountain",
    "count": 1
  }
}