Images

curl "https://yesterdays.maprva.org/api/v2/images/"

import requests

response = requests.get("https://yesterdays.maprva.org/api/v2/images/")
data = response.json()

library(httr2)

resp <- request("https://yesterdays.maprva.org/api/v2/images/") |>
  req_perform()
data <- resp_body_json(resp)

curl "https://yesterdays.maprva.org/api/v2/images/?source=2&georeferenced=true&year_min=1900&year_max=1920"

import requests

response = requests.get("https://yesterdays.maprva.org/api/v2/images/", params={
    "source": 2,
    "georeferenced": "true",
    "year_min": 1900,
    "year_max": 1920,
})
data = response.json()

library(httr2)

resp <- request("https://yesterdays.maprva.org/api/v2/images/") |>
  req_url_query(source = 2, georeferenced = "true", year_min = 1900, year_max = 1920) |>
  req_perform()
data <- resp_body_json(resp)

# Most recently georeferenced images first
curl "https://yesterdays.maprva.org/api/v2/images/?ordering=-last_georeferenced_at"

import requests

# Most recently georeferenced images first
response = requests.get("https://yesterdays.maprva.org/api/v2/images/", params={
    "ordering": "-last_georeferenced_at",
})
data = response.json()

library(httr2)

# Most recently georeferenced images first
resp <- request("https://yesterdays.maprva.org/api/v2/images/") |>
  req_url_query(ordering = "-last_georeferenced_at") |>
  req_perform()
data <- resp_body_json(resp)

curl "https://yesterdays.maprva.org/api/v2/images/5934/"

import requests

response = requests.get("https://yesterdays.maprva.org/api/v2/images/5934/")
data = response.json()

library(httr2)

resp <- request("https://yesterdays.maprva.org/api/v2/images/5934/") |>
  req_perform()
data <- resp_body_json(resp)

INSTANCE="https://yesterdays.maprva.org"
TOKEN="your-access-token"
COLLECTION_ID=39
FILE=/path/to/photo.tif
MIME=image/tiff

# 1. Request an upload slot.
SLOT=$(curl -s \
  -H "Authorization: Bearer $TOKEN" \
  "$INSTANCE/api/v2/import/upload-url/?collection=$COLLECTION_ID&content_type=$MIME")
SLOT_ID=$(echo "$SLOT" | jq -r .slot_id)
UPLOAD_URL=$(echo "$SLOT" | jq -r .upload_url)

# 2. PUT the file bytes directly to object storage.
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: $MIME" \
  --data-binary "@$FILE"

# 3. Commit the import.
curl -X POST "$INSTANCE/api/v2/import/commit/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d @- <<EOF
{
  "slot_id": "$SLOT_ID",
  "title": "N. 28th and Q Streets",
  "original_date": "9/1956",
  "edtf_date": "1956-09",
  "creator": "Shelton, Edith Keesee",
  "license_name": "CC BY 4.0",
  "source_url": "https://valentine.example/...",
  "description": "35mm color slide...",
  "rotation": 0,
  "mirror": "none"
}
EOF

import requests

INSTANCE = "https://yesterdays.maprva.org"
TOKEN = "your-access-token"
COLLECTION_ID = 39
FILE = "/path/to/photo.tif"
MIME = "image/tiff"

auth = {"Authorization": f"Bearer {TOKEN}"}

# 1. Request an upload slot.
slot = requests.get(
    f"{INSTANCE}/api/v2/import/upload-url/",
    params={"collection": COLLECTION_ID, "content_type": MIME},
    headers=auth,
).json()

# 2. Stream the file directly to object storage.
with open(FILE, "rb") as f:
    put = requests.put(
        slot["upload_url"],
        data=f,
        headers=slot["upload_headers"],
    )
    put.raise_for_status()

# 3. Commit the import.
resp = requests.post(
    f"{INSTANCE}/api/v2/import/commit/",
    headers=auth,
    json={
        "slot_id": slot["slot_id"],
        "title": "N. 28th and Q Streets",
        "original_date": "9/1956",
        "edtf_date": "1956-09",
        "creator": "Shelton, Edith Keesee",
        "license_name": "CC BY 4.0",
        "source_url": "https://valentine.example/...",
        "description": "35mm color slide...",
        "rotation": 0,
        "mirror": "none",
    },
)
resp.raise_for_status()
print(resp.json())  # {"image_id": 5934}

library(httr2)

INSTANCE      <- "https://yesterdays.maprva.org"
TOKEN         <- "your-access-token"
COLLECTION_ID <- 39
FILE          <- "/path/to/photo.tif"
MIME          <- "image/tiff"

auth <- function(req) req_auth_bearer_token(req, TOKEN)

# 1. Request an upload slot.
slot <- request(paste0(INSTANCE, "/api/v2/import/upload-url/")) |>
  auth() |>
  req_url_query(collection = COLLECTION_ID, content_type = MIME) |>
  req_perform() |>
  resp_body_json()

# 2. PUT the file bytes directly to object storage.
request(slot$upload_url) |>
  req_method("PUT") |>
  req_headers(!!!slot$upload_headers) |>
  req_body_file(FILE) |>
  req_perform()

# 3. Commit the import.
resp <- request(paste0(INSTANCE, "/api/v2/import/commit/")) |>
  auth() |>
  req_body_json(list(
    slot_id       = slot$slot_id,
    title         = "N. 28th and Q Streets",
    original_date = "9/1956",
    edtf_date     = "1956-09",
    creator       = "Shelton, Edith Keesee",
    license_name  = "CC BY 4.0",
    source_url    = "https://valentine.example/...",
    description   = "35mm color slide...",
    rotation      = 0,
    mirror        = "none"
  )) |>
  req_perform() |>
  resp_body_json()

INSTANCE="https://yesterdays.maprva.org"
TOKEN="your-access-token"
IMAGE_ID=5934
COLLECTION_ID=39
FILE=/path/to/replacement.tif
MIME=image/tiff

# 1. Request an upload slot.
SLOT=$(curl -s \
  -H "Authorization: Bearer $TOKEN" \
  "$INSTANCE/api/v2/import/upload-url/?collection=$COLLECTION_ID&content_type=$MIME")
SLOT_ID=$(echo "$SLOT" | jq -r .slot_id)
UPLOAD_URL=$(echo "$SLOT" | jq -r .upload_url)

# 2. PUT the file bytes directly to object storage.
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: $MIME" \
  --data-binary "@$FILE"

# 3. Commit the replacement.
curl -X POST "$INSTANCE/api/v2/images/$IMAGE_ID/replace/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"slot_id\": \"$SLOT_ID\"}"

import requests

INSTANCE = "https://yesterdays.maprva.org"
TOKEN = "your-access-token"
IMAGE_ID = 5934
COLLECTION_ID = 39
FILE = "/path/to/replacement.tif"
MIME = "image/tiff"

auth = {"Authorization": f"Bearer {TOKEN}"}

# 1. Request an upload slot.
slot = requests.get(
    f"{INSTANCE}/api/v2/import/upload-url/",
    params={"collection": COLLECTION_ID, "content_type": MIME},
    headers=auth,
).json()

# 2. Stream the file directly to object storage.
with open(FILE, "rb") as f:
    put = requests.put(
        slot["upload_url"],
        data=f,
        headers=slot["upload_headers"],
    )
    put.raise_for_status()

# 3. Commit the replacement.
resp = requests.post(
    f"{INSTANCE}/api/v2/images/{IMAGE_ID}/replace/",
    json={"slot_id": slot["slot_id"]},
    headers=auth,
)
resp.raise_for_status()
print(resp.json())

library(httr2)

INSTANCE      <- "https://yesterdays.maprva.org"
TOKEN         <- "your-access-token"
IMAGE_ID      <- 5934
COLLECTION_ID <- 39
FILE          <- "/path/to/replacement.tif"
MIME          <- "image/tiff"

auth <- function(req) req_auth_bearer_token(req, TOKEN)

# 1. Request an upload slot.
slot <- request(paste0(INSTANCE, "/api/v2/import/upload-url/")) |>
  auth() |>
  req_url_query(collection = COLLECTION_ID, content_type = MIME) |>
  req_perform() |>
  resp_body_json()

# 2. PUT the file bytes directly to object storage.
request(slot$upload_url) |>
  req_method("PUT") |>
  req_headers(!!!slot$upload_headers) |>
  req_body_file(FILE) |>
  req_perform()

# 3. Commit the replacement.
resp <- request(paste0(INSTANCE, "/api/v2/images/", IMAGE_ID, "/replace/")) |>
  auth() |>
  req_body_json(list(slot_id = slot$slot_id)) |>
  req_perform() |>
  resp_body_json()