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 の代わりにリモート画像のURLを渡せます。 |
| mode | string | full（既定）· text · assets |
| format | string | json（既定）· html · zip |
| lang | string | 出力テキストの言語。既定はオリジナルの言語です。 |
| webhook_url | string | 非同期ジョブの完了時に通知するURL。 |
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 | レート制限超過 | 少し待ってから再試行してください。 |