ALUMAX(アルマックス)

1. 概要

本APIは、弊社製品の在庫確認および発注を自動化するためのB2B専用Web APIです。
問屋様・ショップ様のシステムとシームレスな連携を可能にします。

Base URL	`https://hanabishimodel.kachiya.com/api/pub/`
テストURL(Sandbox)	`https://hanabishimodel.kachiya.com/api/test/`
Content-Type	`application/json`
Auth	`API Key required in request header`
Rate limit	`20 req/min`

すべてのリクエストのHTTPヘッダーに、発行されたAPIキーを付与してください。

X-SYSJP-API-KEY: your_32char_unique_api_key

GET

指定したJANコードの現在在庫数を取得します。

Name	Type	Required	Description
`jan`	String	Yes	13桁のJANコード（必須）

{
	"status": "success",
	"jan": "9999999678901",
	"stock_quantity": 45,
	"last_updated": "2026-01-26T12:00:00Z"
}

POST

複数商品の一括注文を受け付け、受注番号を発行します。

{
	"order_reference": "PO-2026-001",
	"items": [
		{ "jan": "9999999678901", "quantity": 10 },
		{ "jan": "9999999678902", "quantity": 5 }
	]
}

{
	"status": "success",
	"order_number": "ALX-20260126-999",
	"message": "Order received successfully."
}

Code	Status	Description
200 / 201	Success / Created	リクエストが正常に処理されました。
401	Unauthorized	APIキーが正しくない、またはリクエストヘッダーに含まれていません。
404	Not Found	該当するJANコードが存在しない、またはエンドポイントのURLが間違っています。
429	Too Many Requests	短期間のリクエスト回数が上限を超えました。しばらく待ってから再試行してください。
500	Internal Server Error	サーバー側で予期せぬエラーが発生しました。