Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
NameTypeSince
version
RequiredValue(s)

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

apisidstring7.4yes

Excerpt

Based on the setting of webapi.default.uid in picapport.properties 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
photoidstring7.4yes

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"

Note

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

Examples