코드 예제: Node.js, Python, PHP, cURL
작업을 제출하고, 백오프를 적용해 완료를 기다리고, 결과를 다운로드하는 전체 예제를 네 가지 언어로 제공합니다. 그대로 복사해 사용할 수 있습니다.
핵심 답변
어떤 언어에서든 같은 세 가지 호출로 동작합니다. Idempotency-Key를 붙여 POST /api/v1/jobs/ 요청을 보내고, 백오프를 적용해 GET /api/v1/jobs/{jobId}/ 요청으로 폴링한 다음, output.downloadUrl을 다운로드합니다. 아래 예제는 시간 제한과 오류 처리를 갖춘 완전한 프로그램입니다. 실행하기 전에 환경 변수 MAXSCANNER_API_KEY를 설정하십시오.
Node.js(18 이상)
내장 fetch를 사용하므로 패키지가 필요 없습니다.
const KEY = process.env.MAXSCANNER_API_KEY;
const BASE = 'https://maxscanner.app/api/v1';
const headers = { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' };
const create = await fetch(`${BASE}/jobs/`, {
method: 'POST',
headers: { ...headers, 'Idempotency-Key': 'report-2026-11-pdf' },
body: JSON.stringify({ url: 'https://example.com/report.docx', filename: 'report.docx', format: 'pdf' }),
});
if (!create.ok) throw new Error(`create failed: ${create.status} ${await create.text()}`);
const { jobId } = await create.json();
let delay = 2000, job;
for (let i = 0; i < 60; i++) {
job = await (await fetch(`${BASE}/jobs/${jobId}/`, { headers })).json();
if (job.status === 'completed' || job.status === 'failed') break;
await new Promise((r) => setTimeout(r, delay));
delay = Math.min(delay * 1.5, 10000);
}
if (job.status !== 'completed') throw new Error(job.error || 'job did not finish');
const file = await fetch(job.output.downloadUrl);
await (await import('node:fs/promises')).writeFile('report.pdf', Buffer.from(await file.arrayBuffer()));Python
import os, time, requests
KEY = os.environ["MAXSCANNER_API_KEY"]
BASE = "https://maxscanner.app/api/v1"
S = requests.Session()
S.headers.update({"Authorization": f"Bearer {KEY}"})
r = S.post(f"{BASE}/jobs/", json={"url": "https://example.com/report.docx", "filename": "report.docx", "format": "pdf"},
headers={"Idempotency-Key": "report-2026-11-pdf"}, timeout=30)
r.raise_for_status()
job_id = r.json()["jobId"]
delay, job = 2.0, {}
for _ in range(60):
job = S.get(f"{BASE}/jobs/{job_id}/", timeout=30).json()
if job["status"] in ("completed", "failed"):
break
time.sleep(delay)
delay = min(delay * 1.5, 10)
if job.get("status") != "completed":
raise RuntimeError(job.get("error") or "job did not finish")
with open("report.pdf", "wb") as fh:
fh.write(requests.get(job["output"]["downloadUrl"], timeout=60).content)PHP
<?php
$key = getenv('MAXSCANNER_API_KEY');
$base = 'https://maxscanner.app/api/v1';
function api(string $method, string $url, string $key, ?array $body = null, array $extra = []): array {
$ch = curl_init($url);
$headers = array_merge(["Authorization: Bearer $key", 'Content-Type: application/json'], $extra);
curl_setopt_array($ch, [CURLOPT_CUSTOMREQUEST => $method, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => $headers, CURLOPT_TIMEOUT => 30]);
if ($body !== null) curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
return $data ?? [];
}
$job = api('POST', "$base/jobs/", $key, ['url' => 'https://example.com/report.docx', 'filename' => 'report.docx', 'format' => 'pdf'], ['Idempotency-Key: report-2026-11-pdf']);
$delay = 2;
for ($i = 0; $i < 60; $i++) {
$status = api('GET', "$base/jobs/{$job['jobId']}/", $key);
if (in_array($status['status'], ['completed', 'failed'], true)) break;
sleep($delay);
$delay = min($delay * 2, 10);
}
if ($status['status'] === 'completed') file_put_contents('report.pdf', file_get_contents($status['output']['downloadUrl']));cURL과 셸
jq가 필요합니다. 애플리케이션 코드를 작성하기 전에 키나 형식을 테스트할 때 편리합니다.
JOB=$(curl -s -X POST 'https://maxscanner.app/api/v1/jobs/' \
-H "Authorization: Bearer $MAXSCANNER_API_KEY" -H 'Content-Type: application/json' \
-H 'Idempotency-Key: report-2026-11-pdf' \
-d '{ "url": "https://example.com/report.docx", "filename": "report.docx", "format": "pdf" }' | jq -r .jobId)
until STATUS=$(curl -s "https://maxscanner.app/api/v1/jobs/$JOB/" -H "Authorization: Bearer $MAXSCANNER_API_KEY"); \
echo "$STATUS" | jq -e '.status == "completed" or .status == "failed"' > /dev/null; do sleep 5; done
curl -s -o report.pdf "$(echo "$STATUS" | jq -r .output.downloadUrl)"OpenAPI와 AI 코딩 도우미
https://maxscanner.app/openapi/maxscanner-v1.yaml 에 있는 OpenAPI 3.1 명세로 평소 사용하는 생성기를 이용해 타입이 지정된 클라이언트를 생성할 수 있습니다. 코딩 도우미는 https://maxscanner.app/llms.txt 와 https://maxscanner.app/ai/api.md 를 읽을 수 있으며, 두 문서에는 같은 엔드포인트와 규칙이 요약되어 있습니다.
자주 묻는 질문
공식 SDK가 있습니까?
아직 없습니다. API 규모가 작아서 위의 예제나 OpenAPI 파일에서 생성한 클라이언트로 충분히 다룰 수 있습니다.