API v1
개발자를 위한 API
한 번의 API 호출로 HTML·CSS·분리 이미지·구조화 JSON·품질 리포트를 받으세요.
01
인증
AUTH모든 요청에 Authorization: Bearer <API_KEY> 헤더가 필요합니다. 키는 로그인 후 내 작업실에서 발급합니다.
02
변환 요청
RECONSTRUCTcURL
curl -X POST https://gumson.com/api/v1/reconstruct \ -H "Authorization: Bearer i2h_your_api_key" \ -F "image_file=@product-page.jpg" \ -F "mode=full" \ -F "format=json"
| 파라미터 | 타입 | 설명 |
|---|---|---|
| image_file | file | 변환할 이미지. JPG·PNG·WebP, 최대 25 MB. |
| image_url | string | image_file 대신 원격 이미지 주소를 넘길 수 있습니다. |
| mode | string | full(기본) · text · assets |
| format | string | json(기본) · html · zip |
| lang | string | 결과 텍스트 언어. 기본은 원문 유지. |
| webhook_url | string | 비동기 모드에서 완료 알림을 받을 주소. |
03
응답
RESPONSEJSON
{
"id": "cnv_9f2a…",
"status": "done",
"sections": 8,
"quality": 94,
"html": "<section class=…>",
"css": ".i2h-hero{…}",
"assets": [
{ "name": "product-01.png", "url": "https://…" }
],
"review_zones": [
{ "y": 4120, "h": 380, "reason": "low_contrast_text" }
]
}
04
상태 코드
ERRORS| 코드 | 의미 | 대응 |
|---|---|---|
| 400 | 요청 형식 오류 | 파라미터를 확인하세요. |
| 401 | 인증 실패 | API 키를 확인하세요. |
| 402 | 크레딧 부족 | 요금제를 확인하세요. |
| 413 | 파일 용량 초과 | 25 MB 이하로 줄여주세요. |
| 429 | 요청 제한 초과 | 잠시 후 재시도하세요. |