Image detail & batch metadata

const imageId = "es_001_example";
const response = await fetch(
  `https://epochalstock.com/api/v1/images/${encodeURIComponent(imageId)}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.EPOCHAL_API_KEY}`,
      Accept: "application/json",
    },
  }
);

if (!response.ok) throw new Error(await response.text());
const { data, meta } = await response.json();
console.log(data.id, data.title, data.thumbnail_url, meta.request_id);

$imageId = 'es_001_example';
$url = 'https://epochalstock.com/api/v1/images/' . rawurlencode($imageId);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('EPOCHAL_API_KEY'),
        'Accept: application/json',
    ],
    CURLOPT_TIMEOUT => 20,
]);
$response = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status !== 200) {
    throw new RuntimeException((string) $response);
}
$payload = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
$image = $payload['data'];
// $image['id'], title, tags, thumbnail_url, preview_url, …

import os
import requests

image_id = "es_001_example"
r = requests.get(
    f"https://epochalstock.com/api/v1/images/{image_id}",
    headers={
        "Authorization": f"Bearer {os.environ['EPOCHAL_API_KEY']}",
        "Accept": "application/json",
    },
    timeout=20,
)
r.raise_for_status()
data = r.json()["data"]
print(data["id"], data["title"], data.get("preview_url"))

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "net/url"
    "os"
    "time"
)

func main() {
    imageID := "es_001_example"
    endpoint := "https://epochalstock.com/api/v1/images/" + url.PathEscape(imageID)

    req, err := http.NewRequest(http.MethodGet, endpoint, nil)
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+os.Getenv("EPOCHAL_API_KEY"))
    req.Header.Set("Accept", "application/json")

    client := &http.Client{Timeout: 20 * time.Second}
    res, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer res.Body.Close()

    body, _ := io.ReadAll(res.Body)
    if res.StatusCode != http.StatusOK {
        panic(fmt.Sprintf("%d %s", res.StatusCode, body))
    }

    var payload struct {
        Data map[string]any `json:"data"`
    }
    if err := json.Unmarshal(body, &payload); err != nil {
        panic(err)
    }
    fmt.Println(payload.Data["id"], payload.Data["title"])
}

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Duration;

String imageId = "es_001_example";
String path = URLEncoder.encode(imageId, StandardCharsets.UTF_8).replace("+", "%20");
String url = "https://epochalstock.com/api/v1/images/" + path;

HttpClient client = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(10))
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .timeout(Duration.ofSeconds(20))
    .header("Authorization", "Bearer " + System.getenv("EPOCHAL_API_KEY"))
    .header("Accept", "application/json")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() != 200) {
    throw new IllegalStateException(response.statusCode() + " " + response.body());
}
// Parse JSON data.id, data.title, data.thumbnail_url, data.preview_url
System.out.println(response.body());

const ids = ["es_001_example", "es_002_example"];

const response = await fetch("https://epochalstock.com/api/v1/images/batch", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.EPOCHAL_API_KEY}`,
    "Content-Type": "application/json",
    Accept: "application/json",
  },
  body: JSON.stringify({ ids }),
});

if (!response.ok) throw new Error(await response.text());
const { data } = await response.json();
console.log(`found ${data.found} of ${data.requested}`);
for (const image of data.images) {
  console.log(image.id, image.title);
}

$ids = ['es_001_example', 'es_002_example'];
$ch = curl_init('https://epochalstock.com/api/v1/images/batch');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('EPOCHAL_API_KEY'),
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['ids' => $ids], JSON_THROW_ON_ERROR),
    CURLOPT_TIMEOUT => 20,
]);
$response = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status !== 200) {
    throw new RuntimeException((string) $response);
}
$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR)['data'];
// $data['images'], $data['requested'], $data['found']

import os
import requests

ids = ["es_001_example", "es_002_example"]
r = requests.post(
    "https://epochalstock.com/api/v1/images/batch",
    json={"ids": ids},
    headers={
        "Authorization": f"Bearer {os.environ['EPOCHAL_API_KEY']}",
        "Accept": "application/json",
    },
    timeout=20,
)
r.raise_for_status()
data = r.json()["data"]
print(f"found {data['found']} of {data['requested']}")
for image in data["images"]:
    print(image["id"], image["title"])

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    body, _ := json.Marshal(map[string]any{
        "ids": []string{"es_001_example", "es_002_example"},
    })

    req, err := http.NewRequest(http.MethodPost,
        "https://epochalstock.com/api/v1/images/batch",
        bytes.NewReader(body))
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+os.Getenv("EPOCHAL_API_KEY"))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Accept", "application/json")

    client := &http.Client{Timeout: 20 * time.Second}
    res, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer res.Body.Close()

    raw, _ := io.ReadAll(res.Body)
    if res.StatusCode != http.StatusOK {
        panic(fmt.Sprintf("%d %s", res.StatusCode, raw))
    }

    var payload struct {
        Data struct {
            Images    []map[string]any `json:"images"`
            Requested int              `json:"requested"`
            Found     int              `json:"found"`
        } `json:"data"`
    }
    if err := json.Unmarshal(raw, &payload); err != nil {
        panic(err)
    }
    fmt.Printf("found %d of %d\n", payload.Data.Found, payload.Data.Requested)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

String json = """
    {"ids":["es_001_example","es_002_example"]}
    """;

HttpClient client = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(10))
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://epochalstock.com/api/v1/images/batch"))
    .timeout(Duration.ofSeconds(20))
    .header("Authorization", "Bearer " + System.getenv("EPOCHAL_API_KEY"))
    .header("Content-Type", "application/json")
    .header("Accept", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() != 200) {
    throw new IllegalStateException(response.statusCode() + " " + response.body());
}
// Parse data.images, data.requested, data.found
System.out.println(response.body());