인증

API 요청 인증 방법을 알아보세요.

인증

Traceline API에 대한 모든 요청은 X-API-Key 헤더에 API 키를 포함해야 합니다. API 키는 대시보드에서 생성할 수 있습니다.

X-API-Key: trl_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4

키 형식

API 키는 식별하기 쉬운 일관된 형식을 따릅니다:

trl_live_ — 모든 키는 식별 및 시크릿 스캐닝을 위해 trl_live_로 시작합니다.
본문 — 암호학적으로 안전한 난수 생성기로 생성된 32자의 16진수.
전체 예시 — trl_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4

키 저장 및 보안

API 키는 서버에서 SHA-256으로 해시됩니다. 평문 키는 생성 시 한 번만 표시되며 이후에는 검색할 수 없습니다. 키를 분실하면 취소하고 새 키를 만드세요.

보안 모범 사례

키를 환경 변수에 저장하고 하드코딩하지 마세요.
.env 파일을 .gitignore에 추가하여 실수로 커밋되지 않도록 하세요.
주기적으로 키를 교체하고 사용하지 않는 키를 취소하세요.
개발용과 프로덕션용으로 별도의 키를 사용하세요.

요청 예시

Traceline API에 대한 모든 요청은 X-API-Key 헤더에 API 키를 포함해야 합니다. API 키는 대시보드에서 생성할 수 있습니다.

cURL

curl -X POST https://api.trace-line.site/v1/palm/analyze \
  -H "X-API-Key: trl_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"image": "<base64-encoded-image>"}'

Python

import os
import requests
import base64

api_key = os.environ["TRACELINE_API_KEY"]

with open("palm.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://api.trace-line.site/v1/palm/analyze",
    headers={
        "X-API-Key": api_key,
        "Content-Type": "application/json",
    },
    json={"image": image_b64},
)

print(response.json())

JavaScript

import { readFileSync } from "fs";

const apiKey = process.env.TRACELINE_API_KEY;
const image = readFileSync("palm.jpg").toString("base64");

const res = await fetch(
  "https://api.trace-line.site/v1/palm/analyze",
  {
    method: "POST",
    headers: {
      "X-API-Key": apiKey,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ image }),
  }
);

const data = await res.json();
console.log(data);