mcpField
E
ecommerce

ecommerce

github.com/hostinger营销与增长2639 次安装19 周前更新
代码仓库

关于 ecommerce

Hostinger Ecommerce API 的技能说明，用于管理 Hostinger 账户关联的在线商店。它涵盖分页列出商店、创建商店及销售渠道设置。

主要功能

  1. 01分页列出商店
  2. 02创建商店
  3. 03自动创建主销售渠道
  4. 04关联外部销售渠道

适用场景

  1. 01查看账户中的商店
  2. 02为新业务创建在线商店
  3. 03将商店关联到外部系统

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hostinger/hostinger-agent-skills --skill ecommerce

安装后在 Claude Code 中输入/ecommerce确认已加载。

详细介绍

Hostinger Ecommerce

Ecommerce API 用于管理与你 Hostinger 账户关联的在线商店。你可以列出已有商店并创建新商店——创建商店时还会为其配置一个主要销售渠道。

目录

核心概念

商店

商店是与你的账户绑定的顶层电子商务实体。每个商店都包含公司信息（名称、邮箱、国家/地区）以及用于店面展示的默认语言。

销售渠道

每个商店至少有一个 销售渠道——即销售产品的界面。创建商店时，会同时创建一个 主要销售渠道。你可以提供一个 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创建商店（同时创建主要销售渠道）
创建商店请求体
字段类型描述
namestring商店名称
country_codestringISO 国家/地区代码（例如 us）
company_emailstring公司联系邮箱
company_namestring公司名称
languagestring默认店面语言（例如 en）
sales_channelobject可选。{ "type": "custom", "external_id": "..." }

最佳实践

商店设置
  • 将 country_code 和 language 设置为与你的目标市场一致——它们决定店面默认值
  • 使用一个受监控的 company_email——它会接收与商店相关的通知
  • 与外部系统集成时，提供 sales_channel.external_id，以便日后对账
列出商店
  • 当账户拥有大量商店时，使用 page 分页，而不是假定只有一页

故障排查

401 未授权
  • 验证你的 API 令牌有效且未过期
  • 检查 Authorization: Bearer <token> 请求头格式
422 无法处理的内容
  • country_code 无效（请使用有效的 ISO 代码，如 us）或 company_email 格式错误
  • 提供 sales_channel 对象时缺失或格式错误
创建后商店未显示
  • 重新列出商店——传播可能需要一点时间
  • 确认创建请求返回了成功状态和商店 ID

参考资料

评论

支持 Markdown