API 문서

export BASE=https://url2shot.rexjeong.com
export KEY=YOUR_API_KEY
export REQUEST_ID=$(uuidgen)

curl -X POST "$BASE/v1/screenshots" \
  -H "Authorization: Bearer $KEY" \
  -H "Idempotency-Key: $REQUEST_ID" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","format":"png"}'

# 응답의 id로 상태 조회
curl "$BASE/v1/screenshots/JOB_ID" \
  -H "Authorization: Bearer $KEY"

# status=succeeded 이후 다운로드 링크 발급
curl -X POST "$BASE/v1/screenshots/JOB_ID/download-url" \
  -H "Authorization: Bearer $KEY"

const base = process.env.URL2SHOT_BASE ?? 'https://url2shot.rexjeong.com';
const headers = {
  Authorization: 'Bearer ' + process.env.URL2SHOT_KEY,
  'Content-Type': 'application/json'
};
// 네트워크 재전송에는 이 idempotency key를 그대로 사용합니다.
const idempotencyKey = crypto.randomUUID();
const created = await fetch(base + '/v1/screenshots', {
  method: 'POST',
  headers: { ...headers, 'Idempotency-Key': idempotencyKey },
  body: JSON.stringify({ url: 'https://example.com' })
});
if (!created.ok) throw new Error(await created.text());
const { id } = await created.json();
let downloadUrl;
for (let attempt = 0; attempt < 90; attempt++) {
  const response = await fetch(base + '/v1/screenshots/' + id, { headers });
  if (!response.ok) throw new Error(await response.text());
  const job = await response.json();
  if (job.status === 'succeeded') {
    const link = await fetch(base + '/v1/screenshots/' + id + '/download-url', {
      method: 'POST', headers
    });
    if (!link.ok) throw new Error(await link.text());
    downloadUrl = (await link.json()).url;
    break;
  }
  if (['failed', 'expired'].includes(job.status)) throw new Error(job.error.code);
  await new Promise(resolve => setTimeout(resolve, 3500));
}
if (!downloadUrl) throw new Error('Query this job again later: ' + id);
console.log(downloadUrl);

# 저장소 루트에서 빌드 후 실행
npm run sdk:build
export URL2SHOT_BASE=https://url2shot.rexjeong.com
export URL2SHOT_KEY=YOUR_API_KEY
node examples/capture.mjs
# TypeScript: node examples/capture.ts

import { randomUUID } from 'node:crypto';
import { Url2Shot } from '@url2shot/sdk';

const apiKey = process.env.URL2SHOT_KEY;
const baseUrl = process.env.URL2SHOT_BASE;
if (!apiKey || !baseUrl) throw new Error('URL2SHOT_KEY와 URL2SHOT_BASE를 설정하세요.');
const client = new Url2Shot({ apiKey, baseUrl });
const key = randomUUID(); // 요청 전에 저장하고 재전송에 같은 키 사용
const job = await client.captureAndWait(
  { url: 'https://example.com', format: 'png' },
  { idempotencyKey: key },
);
await client.save(job.id, 'capture-' + job.id + '.png');
const usage = await client.getUsage();