用途:Hostinger Ecommerce API 用于管理 Hostinger 账户下的在线商店,主要支持两项操作——列出账户中的商店,以及创建新商店。创建商店时会同时为其自动配置一个主销售渠道。
主要能力:商店是账户下的顶层电商实体,包含公司信息(名称、邮箱、国家)和店铺默认语言。每个商店至少有一个销售渠道,即商品销售的入口;创建商店时自动生成主销售渠道,也可通过可选的 sales_channel 对象(如 type: custom 加 external_id)将商店关联到外部系统。
使用方式:接口基址为 https://developers.hostinger.com/api/ecommerce/v1/stores,需在请求头携带 Authorization: Bearer $HOSTINGER_API_TOKEN。列出商店用 GET,支持通过 page 参数分页;创建商店用 POST,请求体字段包括 name、country_code、company_email、company_name、language,以及可选的 sales_channel。官方提供 Python、TypeScript、PHP SDK 及 CLI 工具,例如 Python 中可用 client.ecommerce.stores.list() 获取商店列表。
适用场景:适合需要以编程方式批量查看或初始化 Hostinger 商店、并与外部系统对接的开发者。
限制与注意:资料未提供收费、价格、配额或速率限制等信息。常见错误包括 401(令牌无效或过期、请求头格式错误)和 422(country_code 非有效 ISO 代码、company_email 格式错误、sales_channel 对象缺失或格式错误)。创建后商店若未立即出现,可重新列出,传播可能需要一点时间,并确认创建请求返回成功状态和商店 ID。建议 country_code 与 language 匹配目标市场,使用可监控的 company_email,并在对接外部系统时提供 sales_channel.external_id 以便后续对账。