Page tree
Skip to end of metadata
Go to start of metadata

Option1: get photo from a shared gallery

sidstring7.4yesShareID. Unique sid returned by getSharedGallerys or by the Web-GUI function share photos
indexint7.4yesZero based index of requested photo in shared gallery.

Option2: get photo from an already executed runQuery


Based on the setting of webapi.default.uid in you may provide one of the following values

  • Session-ID returned from createWebApiSession

  • If you do not provide apisid and configuration parameter webapi.default.uid is set to a valid userid (with same password)
    a WebApi-Session will be created implicitly for the defined user.

  • If an existing userID is provided (with password set to same value as userID ) a WebApi-Session will be created implicitly
    for the defined userID.

vidint7.4yesViewID returned from runQuery
indexint7.4yesZero based index of requested photo in view returned by runQuery
Option3: get a single photo from a unique photoID
apisidstring7.4yesdesciption see above option2

A valid photo id to uniquely identify a photo. see: PhotoID on page Full text search of photos - Supported metadata

If photoid is provided as parameter, vid and index will be ignored even if they are provided

Since version 7.4 you can query the photoid in the thumbnail view. Select one or more photos and then menu: tags -> "show metadata details"

Because the photoid is a base64 encoded String it may contain '+' or '/' characters. The proper escaping for the URL is:

  • %2B for '+'
  • %2F for '/'

You can also use JavaScripts encodeURIComponent() function.

See examples below

With this option3 it is now possible to directly link to a photo in PicApport without having to deal with sessions etc. if you provide a webapi.default.uid or a valid userID for apisid



  • No labels