album.getPublicImage

public

Get a visitor photo within a published album

Returns the full description and adjacent visible photo IDs. Authentication never changes the visitor view.

Parameters

Passed by name in the params object.

Result

Returns AlbumImage:

Errors

See the error reference for the full catalog, including the authentication codes.

Example

Request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "album.getPublicImage",
  "params": {
    "token": "abcdefghijklmnopqrstuv",
    "photo_id": "018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d"
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "image": {
      "id": "018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d",
      "index": 1,
      "title": "Mountain pass",
      "description": "",
      "alt": "Mountain pass",
      "width": 640,
      "height": 480,
      "renders": [
        {
          "url": "https://img.example.com/r/018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d/medium.webp?v=1",
          "format": "webp",
          "width": 640,
          "height": 480
        }
      ]
    },
    "total": 1,
    "prev_id": "",
    "next_id": ""
  }
}

curl

curl -s https://peinture.gumeniuk.com/rpc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"album.getPublicImage","params":{"token":"abcdefghijklmnopqrstuv","photo_id":"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d"}}'

JavaScript

const res = await fetch("https://peinture.gumeniuk.com/rpc", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0", id: 1, method: "album.getPublicImage", params: {"token":"abcdefghijklmnopqrstuv","photo_id":"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d"},
  }),
});
const { result, error } = await res.json();

Go

body := []byte(`{"jsonrpc":"2.0","id":1,"method":"album.getPublicImage","params":{"token":"abcdefghijklmnopqrstuv","photo_id":"018f3a7d-2b8c-7f1a-a4d5-6e7f8a9b0c1d"}}`)
req, _ := http.NewRequest("POST", "https://peinture.gumeniuk.com/rpc", bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)