Przykłady API

Praktyczne przykłady dla najważniejszych flow integracji HFT71.

1) Autoryzacja

Endpoint:

• POST /authentication/login

Przykładowy request:

{
  "username": "api-user@example.com",
  "password": "your-password"
}

Przykładowy response:

{
  "access_token": "eyJhbGciOi...",
  "expires_in": 300,
  "token_type": "Bearer"
}

2) Wysłanie zamówienia

Endpoint:

• POST /order

Przykładowy payload:

{
  "referenceId": "72774",
  "orderDate": "2026-03-02",
  "address": {
    "address1": "Main Street 10",
    "address2": "",
    "city": "Wroclaw",
    "zip": "50-001",
    "state": "DS",
    "country": "PL",
    "customerName": "John Doe",
    "email": "john@example.com",
    "mobile": "+48123456789"
  },
  "items": [
    {
      "sku": "GL64000-00007-0046",
      "quantity": 2
    }
  ]
}

3) Polling statusu

Endpoint:

• GET /order/{orderId}/status

Przykładowy response:

[
  {
    "sku": "GL64000-00007-0046",
    "status": "In Production"
  }
]

4) Webhook do WooCommerce

Endpoint:

• POST /wp-json/hft71/v1/order-status

Przykładowy body:

{
  "external_id": "123456",
  "status": "Closed"
}

5) Synchronizacja stocku

Endpoint:

• GET /stock/available?page=1&count=200

Przykładowy response:

[
  {
    "sku": "GL64000-00007-0046",
    "stock": 18
  }
]

6) Aktualizacja dwukierunkowa

Endpoint:

• PUT /order/{orderId}

Przykładowy payload statusu:

{
  "orderStatus": "Closed"
}

7) Odczyt konfiguracji modeli (helpery WordPress)

Od v1.3.0 dane modeli produktów są w tabelach pluginu i udostępniane przez publiczne helpery PHP (nie endpointy REST):

$models = hft71_get_models();
$config = hft71_get_model( 'BY004' );
$sku    = hft71_get_model_sku( 'BY004', 'Black', 'M' );
$map    = hft71_get_model_sku_map( 'BY004' );

Przykładowy znormalizowany obiekt z hft71_get_model() (patrz schemas/model-config.schema.json):

{
  "code": "BY004",
  "label": "Classic T-Shirt",
  "description": "<p>…</p>",
  "base_price": 29.99,
  "double_sided_surcharge": 5.0,
  "wc_category_id": 42,
  "sizes": ["S", "M", "L", "XL"],
  "colors": [
    { "name": "Black", "hex": "#000000" }
  ],
  "skus": {
    "Black": {
      "M": "GL64000-00007-0046"
    }
  }
}

Wszystkie helpery mają filtry (hft71_get_models, hft71_get_model, itd.). Zmiany cen wywołują akcję hft71_model_price_changed.