Quickstart

import os
import uuid
import requests

base = "https://back.tilion.dev"
headers = {"Authorization": f"Bearer {os.environ['TILION_API_KEY']}"}
response = requests.post(
    f"{base}/v1/session",
    headers={**headers, "Idempotency-Key": str(uuid.uuid4())},
    json={}, timeout=200,
)
response.raise_for_status()
session_id = response.json()["session_id"]

try:
    response = requests.post(
        f"{base}/v1/fetch", headers=headers,
        json={"session_id": session_id, "url": "https://example.com/"},
        timeout=70,
    )
    response.raise_for_status()
    page = response.json()
    if not page.get("content_ok"):
        raise RuntimeError(f"Page not delivered: {page}")
    print(page["text"])
finally:
    response = requests.delete(
        f"{base}/v1/session/{session_id}", headers=headers, timeout=30
    )
    response.raise_for_status()

import { randomUUID } from "node:crypto";

const base = "https://back.tilion.dev";
const headers = {
  Authorization: `Bearer ${process.env.TILION_API_KEY}`,
  "Content-Type": "application/json",
};
async function request(path, method, body, extraHeaders = {}) {
  const response = await fetch(`${base}${path}`, {
    method, headers: { ...headers, ...extraHeaders },
    body: body === undefined ? undefined : JSON.stringify(body),
    signal: AbortSignal.timeout(200_000),
  });
  if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
  return response.status === 204 ? null : response.json();
}
const session = await request("/v1/session", "POST", {}, {
  "Idempotency-Key": randomUUID(),
});
try {
  const page = await request("/v1/fetch", "POST", {
    session_id: session.session_id, url: "https://example.com/",
  });
  if (!page.content_ok) throw new Error(JSON.stringify(page));
  console.log(page.text);
} finally {
  await request(`/v1/session/${session.session_id}`, "DELETE");
}

# Run as a bash script. Requires jq and uuidgen.
set -euo pipefail
BASE="https://back.tilion.dev"
CREATE_ID=$(uuidgen)
SESSION=$(curl --fail-with-body --silent --show-error "$BASE/v1/session" \
  -H "Authorization: Bearer $TILION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $CREATE_ID" -d '{}')
SESSION_ID=$(printf '%s' "$SESSION" | jq -er '.session_id')
cleanup() {
  curl --fail-with-body --silent --show-error -X DELETE \
    "$BASE/v1/session/$SESSION_ID" \
    -H "Authorization: Bearer $TILION_API_KEY"
}
trap cleanup EXIT
curl --fail-with-body --silent --show-error "$BASE/v1/fetch" \
  -H "Authorization: Bearer $TILION_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg sid "$SESSION_ID" \
    '{session_id: $sid, url: "https://example.com/"}')" \
  | jq -er 'if .content_ok then .text else error(tostring) end'