データAPI
この章では、Commerbleの提供するWeb APIのうちデータAPIについて説明します。 データAPIでは、Commerbleに保存されているデータにアクセスできます。 また、アクセスするデータによって以下の3つのエンドポイントに分かれ …
この章では、Commerbleの管理用Web APIについて説明します。
このAPIは管理用です。カート処理用のWeb APIではないことに留意が必要です。
つまりこれはJAMStackで構成されたECサイト（フロントサイト）から使用する購入APIとしては機能しないことを意味します。
そのようなAPIが必要な場合はカスタマイズ実績：カートのWeb API化をご参照ください。
エンドポイント
CommerbleではWEB APIをREST形式で提供しています。REST仕様はODataに則っています。
ODataのバージョンは旧フィードAPIがV3、現行API(data)がV4を提供しています。
| エンドポイント | 種類 | ODataバージョン | 状態 |
|---|---|---|---|
| ~/ec.feed/odata.svc | EC Feed | V3 | 廃止 |
| ~/ec.feed.v2/odata.svc | EC Feed | V3 | 廃止予定 |
| ~/ec.feed.v3/odata.svc | EC Feed | V3 | 廃止予定 |
| ~/ec.feed.v4/odata.svc | EC Feed | V3 | |
| ~/ec.feed.v5/odata.svc | EC Feed | V3 | |
| ~/cms.feed/list/odata.svc | CMS Feed | V3 | 廃止 |
| ~/cms.feed.v2/list/odata.svc | CMS Feed | V3 | |
| ~/cms.feed/metadata/odata.svc | Meta Feed | V3 | 廃止 |
| ~/cms.feed.v2/metadata/odata.svc | Meta Feed | V3 | |
| ~/data/ec | EC Feed | V4 | |
| ~/data/cms | CMS Feed | V4 | |
| ~/data/meta | Meta Feed | V4 | |
| ~/data/query | Custom View | V4 | |
| ~/data/template/validate | Front Template Validator | - | |
| ~/data/query/validate | Query Template Validator | - | |
| ~/data/mail/validate | Mail Template Validator | - |
- EC Feed
- 共通スキーマのデータにアクセスできます
- CMS Feed
- 各テナントごとに設定したスキーマのデータにアクセスできます
- Meta Feed
- テンプレートデータ及びルーティングデータにアクセスできます
- Custom View
- カスタムビューテンプレートを実行できます
- Front Template Validator
- フロントテンプレートを検証できます
- Query Template Validator
- カスタムビューテンプレートを検証できます
- Mail Template Validator
- メールテンプレートを検証できます
エンドポイントのフルURLと認証情報は契約後にご提供いたします。
認証
FeedRead/Writeロールが付与された管理サイトアカウントをベーシック認証で使用します。
同一アカウントで3回パスワードが間違われた場合はアカウントロックされます。
制限
Web APIの利用に対して、単位時間当たりのアクセス可能数などの利用制限はありません。 業務ドメインに基づいて、必要な回数分のリクエストを実施できます。
ただし、更新する必要のないデータを頻繁に入れ替えるなど、大量のAPIコールを日常的に実施することは避けてください。
モニタリングでそれらの兆候が観測された場合は、Commerble社から確認・状況の改善のご協力をお願いすることがあります。