Berryproof API v1

콘솔의 포인트 · API 설정에서 API 키를 받습니다. API로 요청한 것은 콘솔 검수 내역의 'API 연동' 탭에서 내 서비스 요청 번호(external_ref)와 함께 볼 수 있습니다. 모든 요청에 헤더를 붙입니다.

Authorization: Bearer bp_live_xxxxxxxx

로컬 데모 키: bp_test_demo_agency_key

curl -X POST https://berryproof.com/api/v1/reviews \
  -H "Authorization: Bearer bp_test_demo_agency_key" \
  -H "Content-Type: application/json" \
  -d '{"template":"ai_code_security","text":"db.query(\"SELECT * FROM users WHERE id = \" + id)","guarantee_tier":"plus","sla":"standard","external_ref":"pr-482"}'

# 템플릿 없이 범용 검수 + 우리 기준
curl -X POST https://berryproof.com/api/v1/reviews -H "Authorization: Bearer ..." -H "Content-Type: application/json" \
  -d '{"text":"Dear customer, ...","locale":"en","custom_checks":["Formal tone only","Never mention competitors"]}'

# 웹사이트 검수 + 맥락
curl -X POST https://berryproof.com/api/v1/reviews -H "Authorization: Bearer ..." -H "Content-Type: application/json" \
  -d '{"template":"website_copy","media_url":"https://example.com","text":"(첫 화면 문구)",
       "context":{"purpose":"샐러드 구독 첫 화면","audience":"40대 직장인","brand":"친근한 말투"}}'

응답은 두 가지입니다.

• 바로 검수 (status: "queued"): 전문가에게 배정됐어요. 끝나면 웹훅 review.completed 의 result 가 결과입니다.
• 견적 (quote_only: true → status: "quoted"): quote 에 검수 방식별 포인트가 옵니다.

"quote": [
  { "guarantee_tier": "none",  "label": "빠르게 확인",  "hours": 1,  "price": 4400 },
  { "guarantee_tier": "basic", "label": "꼼꼼하게 검수", "hours": 24, "price": 26000 }
]

포인트(1P = 1원): 요청마다 검수 종류와 분량에 따라 포인트가 빠집니다. 결제 방식은 포인트 충전 · 월 구독 · 쓴 만큼 정산(월 한도) 중 하나예요. 쓸 수 있는 포인트나 월 한도가 모자라면 402 를 돌려주고 요청을 받지 않습니다. 가입하면 테스트 포인트 20,000P를 드리고, 콘솔 포인트 · API 설정에서 충전·변경합니다. 콘솔에서 직접 맡긴 검수도 같은 포인트에서 빠집니다. 검수 오류로 환불되면 포인트로 돌아옵니다.

API로 받는 건 표준 검수만이에요. 웹사이트·앱 인수 검수, 논문처럼 고객 의도를 먼저 맞춰야 하는 프로젝트 검수(GET /api/v1/templates 의 track: "project", api_available: false)는 요구사항 기준표를 확정해야 해서 콘솔(/app/projects/new)에서만 받고, API로 요청하면 422를 돌려줘요.

curl -X POST https://berryproof.com/api/v1/reviews/rv_xxx/start -H "Authorization: Bearer ..." -H "Content-Type: application/json" \
  -d '{"guarantee_tier":"basic","sla":"standard"}'

quoted 상태에서만 됩니다. 이때 포인트가 빠지고 queued 로 바뀝니다.

상태(quoted 견적 → queued 배정 → in_review 전문가 검수 중 → completed)와 결과를 조회합니다. 목록은 GET /api/v1/reviews?limit=20.

검수가 끝나면 등록한 주소로 POST 합니다. 본문은 { type: "review.completed", data: <review> } 이고 최종 판정(result.verdict: pass·needs_fix·reject), 수정안, 근거 조항, 검수자 자격, 인증서 링크가 들어 있습니다.

서명 헤더 X-Berryproof-Signature: sha256=HMAC_SHA256(webhook_secret, raw_body) 로 진위를 확인하세요.

import crypto from "node:crypto";
const expected = "sha256=" + crypto.createHmac("sha256", WEBHOOK_SECRET).update(rawBody).digest("hex");
if (req.headers["x-berryproof-signature"] !== expected) return res.status(401).end();

검수 인증서, 검수 범위, 콘텐츠 해시, 배지 링크(badge_url, badge_html), 감사 로그를 돌려줍니다. 공개 검증 페이지는 https://berryproof.com/verify/{id}.

curl -X POST https://berryproof.com/api/v1/claims -H "Authorization: Bearer ..." -H "Content-Type: application/json" \
  -d '{"certificate_id":"BP-2026-XXXXXXXX","description":"'AI 생성 표시' 항목이 통과됐는데 실제로는 표시가 빠져 있었어요"}'

원 검수자가 아닌 L3 검수자가 원래 판단을 보지 않고 72시간 안에 다시 판정하고, 그 판정이 곧 결과입니다. 검수 오류면 그 건 검수료를 포인트로 돌려드립니다. 결과물 사용으로 생긴 손해는 보상하지 않습니다. 보낼 것: certificate_id, description, evidence(선택). 그 전에 콘솔에서 검수 결과에 대한 의견을 같은 전문가에게 먼저 보낼 수 있어요(등급별 포함 횟수). 조건은 검수 정책.

분야(domain)와 기준 국가(region)별 체크리스트 묶음입니다. 맞는 템플릿이 없으면 general + custom_checks 로 시작하세요.

작업량에 비례합니다. 예상 작업 시간 × 분야별 전문가 시급 ÷ 50%(전문가 몫). 작업 시간은 글자 수·페이지·사이트·이미지 수에 비례하고, 응답의 price 에 이번 건 포인트가 옵니다. 아래는 기준 분량일 때예요.

• 빠르게 확인은 none, 꼼꼼하게 검수는 basic·plus 등급일 때예요. 모두 전문가가 직접 확인해요.
• basic: 표준 검수 · 의견 보내기 2회 포함 — +0P
• plus: L3 정밀 검수 · 의견 보내기 3회 포함 — +15,000P
• premium: 엔터프라이즈 (별도 계약) — API 신청 불가
• 긴급(urgent, 2시간): +20,000P
• 결제 방식: 포인트 충전(자동 충전 가능) · 월 구독(라이트 월 50,000원 → 55,000P, 프로 월 200,000원 → 230,000P, 비즈니스 월 500,000원 → 600,000P, 이월 안 됨) · 쓴 만큼 정산(월 한도).