跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
营销与销售

ecommerce

Hostinger Ecommerce API for managing online stores. Use when listing the stores on an account or creating a new store (which also provisions a primary sales channel).

hostinger · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add hostinger/hostinger-agent-skills --skill ecommerce

技能说明


name: ecommerce description: Hostinger Ecommerce API for managing online stores. Use when listing the stores on an account or creating a new store (which also provisions a primary sales channel). last_updated: "2026-06-12" doc_source: https://developers.hostinger.com

Hostinger Ecommerce

The Ecommerce API manages online stores associated with your Hostinger account. You can list existing stores and create new ones — creating a store also provisions a primary sales channel for it.

Table of Contents

Core Concepts

Stores

A store is the top-level ecommerce entity tied to your account. Each store carries company details (name, email, country) and a default language used for the storefront.

Sales Channels

Every store has at least one sales channel — the surface through which products are sold. When you create a store, a primary sales channel is created alongside it. You can supply a sales_channel object (e.g., type: custom with an external_id) to link the store to an external system.

Common Patterns

List Stores

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";
}

Create a Store

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": "owner@example.com",
    "company_name": "My Company",
    "language": "en",
    "sales_channel": {
      "type": "custom",
      "external_id": "ext-12345"
    }
  }'

A primary sales channel is created automatically with the store. The sales_channel object is optional — omit it to use the default.

API Reference

Stores

MethodEndpointDescription
GET/api/ecommerce/v1/storesGet stores (paginated via page)
POST/api/ecommerce/v1/storesCreate a store (also creates a primary sales channel)

Create Store Body

FieldTypeDescription
namestringStore name
country_codestringISO country code (e.g., us)
company_emailstringCompany contact email
company_namestringCompany name
languagestringDefault storefront language (e.g., en)
sales_channelobjectOptional. { "type": "custom", "external_id": "..." }

Best Practices

Store Setup

  • Set country_code and language to match your target market — they drive storefront defaults
  • Use a monitored company_email — it receives store-related notifications
  • Provide a sales_channel.external_id when integrating with an external system so you can reconcile records later

Listing

  • Paginate with page when an account has many stores rather than assuming a single page

Troubleshooting

401 Unauthorized

  • Verify your API token is valid and not expired
  • Check the Authorization: Bearer <token> header format

422 Unprocessable Content

  • Invalid country_code (use a valid ISO code like us) or malformed company_email
  • Missing or malformed sales_channel object when one is provided

Store Not Appearing After Creation

  • Re-list stores — propagation may take a moment
  • Confirm the create request returned a success status and a store ID

References