ecommerce

Hostinger Ecommerce

Ecommerce API は、Hostinger アカウントに関連付けられたオンラインストアを管理します。既存のストアを一覧表示したり、新しいストアを作成したりできます。ストアを作成すると、プライマリ販売チャネルも同時に作成されます。

目次

• 基本概念
• 一般的なパターン
• API リファレンス
• ベストプラクティス
• トラブルシューティング
• 参考資料

基本概念

ストア

ストアは、アカウントに紐付く最上位の E コマースエンティティです。各ストアには、会社情報（名前、メールアドレス、国）と、ストアフロントで使用するデフォルト言語が設定されています。

販売チャネル

すべてのストアには、商品を販売する場所となる販売チャネルが少なくとも 1 つあります。ストアを作成すると、プライマリ販売チャネルも同時に作成されます。sales_channel オブジェクト（たとえば、type: custom と external_id）を指定して、ストアを外部システムにリンクできます。

一般的なパターン

ストアの一覧表示

curl -X GET "https://developers.hostinger.com/api/ecommerce/v1/stores" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Paginate
curl -X GET "https://developers.hostinger.com/api/ecommerce/v1/stores?page=2" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

Python SDK:

from hostinger_api import Hostinger

client = Hostinger(api_token="YOUR_API_TOKEN")

stores = client.ecommerce.stores.list()
for store in stores:
    print(store.name)

TypeScript SDK:

import { Hostinger } from "hostinger-api-sdk";

const client = new Hostinger({ apiToken: "YOUR_API_TOKEN" });

const stores = await client.ecommerce.stores.list();
for (const store of stores) {
  console.log(store.name);
}

PHP SDK:

use Hostinger\Api\HostingerApi;

$client = new HostingerApi('YOUR_API_TOKEN');

$stores = $client->ecommerce->stores->list();
foreach ($stores as $store) {
    echo $store->name . "\n";
}

ストアの作成

curl -X POST "https://developers.hostinger.com/api/ecommerce/v1/stores" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Store",
    "country_code": "us",
    "company_email": "[email protected]",
    "company_name": "My Company",
    "language": "en",
    "sales_channel": {
      "type": "custom",
      "external_id": "ext-12345"
    }
  }'

プライマリ販売チャネルはストアと同時に自動作成されます。sales_channel オブジェクトは省略可能です。省略するとデフォルトが使用されます。

API リファレンス

ストア

メソッド	エンドポイント	説明
GET	/api/ecommerce/v1/stores	ストアを取得します（page によるページネーション）
POST	/api/ecommerce/v1/stores	ストアを作成します（プライマリ販売チャネルも作成されます）

ストア作成リクエストボディ

フィールド	型	説明
name	string	ストア名
country_code	string	ISO 国コード（例：us）
company_email	string	会社の連絡先メールアドレス
company_name	string	会社名
language	string	ストアフロントのデフォルト言語（例：en）
sales_channel	object	省略可能です。{ "type": "custom", "external_id": "..." }

ベストプラクティス

ストアの設定

• country_code と language は対象市場に合わせて設定してください。これらはストアフロントのデフォルト設定に反映されます
• 監視している company_email を使用してください。ストアに関する通知が届きます
• 外部システムと連携する場合は、後でレコードを照合できるように sales_channel.external_id を指定してください

一覧表示

• アカウントに多数のストアがある場合は、1 ページだけだと決めつけず、page を使ってページネーションしてください

トラブルシューティング

401 Unauthorized

• API トークンが有効で、有効期限が切れていないことを確認してください
• Authorization: Bearer <token> ヘッダーの形式を確認してください

422 Unprocessable Content

• country_code が無効です（us のような有効な ISO コードを使用してください）、または company_email の形式が正しくありません
• sales_channel オブジェクトを指定した場合に、オブジェクトが欠落しているか、形式が正しくありません

作成後にストアが表示されない

• ストアを再度一覧表示してください。反映までに少し時間がかかる場合があります
• 作成リクエストが成功ステータスとストア ID を返したことを確認してください

参考資料

• Hostinger API ドキュメント
• Hostinger API 変更履歴
• Python SDK
• TypeScript SDK
• PHP SDK
• CLI ツール