Asgard API
Kompleksowa dokumentacja

POST /api/token/
Content-Type: application/json

{
  "username": "twoj_login",
  "password": "twoje_haslo"
}

{
  "access":  "eyJhbGci...",   // <-- używaj tego, wygasa po 5 min
  "refresh": "eyJhbGci..."    // <-- do odświeżenia, ważny 1 dzień
}

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

GET  /api/products-index/             // lista wszystkich
GET  /api/products-index/ABC-123/      // jeden produkt po indeksie
Authorization: Bearer <token>

GET  /api/client-products/AP800001-01/?qty=100
Authorization: Bearer <token>

// Odpowiedź:
{
  "id":                 142,
  "index":              "AP800001-01",
  "quantity":           4520,
  ... // wszystkie pola jak w products-index
  "currency":           "PLN",
  "catalogue_price":    "10.00",   // cena katalogowa netto
  "purchase_price":     "7.90",   // Twoja cena zakupu netto
  "price_source":       "individual",
  "no_discount":        true,
  "discount_percent": "10.00"
}

GET  /api/stock-info/
Authorization: Bearer <token>

// Odpowiedź:
{
  "count":    1250,
  "next":     "/api/stock-info/?page=2",
  "previous": null,
  "results": [
    { "index": "ABC-123", "quantity": 450 },
    { "index": "XYZ-007", "quantity": 0 },
    ...
  ]
}

// Produkty z kategorii ID=5 z rabatem
GET  /api/products-index/?category=5&discount_prices=true

// Nowości - strona 2
GET  /api/products-index/?new_product=true&page=2

// Szukaj po fragmencie indeksu
GET  /api/products-index/?search=ABC

// Kategorie i podkategorie
GET  /api/categories/
GET  /api/subcategories/

{
  "id":              142,
  "index":         "ABC-123",
  "quantity":      450,
  "active":        true,
  "new_product":   false,
  "promotion":     false,
  "sale":          false,
  "discount_prices": true,
  "category":      5,
  "subcategory":   12,

  "names": [
    { "id": 1, "language": "name_pl", "title": "Kubek termiczny 350ml" },
    { "id": 2, "language": "name_en", "title": "Thermal mug 350ml" }
  ],

  "prices": [
    { "pln": "24.90", "eur": "5.80", "chf": "5.50", "czk": "138.00" }
  ],

  "image": [
    { "url": "https://cdn.example.com/products/abc-123-1.jpg" },
    { "url": "https://cdn.example.com/products/abc-123-2.jpg" }
  ],

  "future_delivery": [
    { "quantity": 200, "date": "2026-03-15" }
  ],

  "additional": [
    { "item": "wymiary", "value": "8.5 x 8.5 x 12 cm" },
    { "item": "waga",    "value": "210g" }
  ],

  "marking_data": [ /* patrz sekcja Znakowanie */ ],

  // ... names, descriptions, madeof, marking (text)
}

// Krok 1 — znajdź ID produktu
GET  /api/products-index/ABC-123/
// → w odpowiedzi znajdziesz "id": 142 oraz zagnieżdżone "marking_data"

// Krok 2 — lub bezpośrednio przez marking-data
GET  /api/marking-data/?product=142

// Odpowiedź (nested):
{
  "id":                    18,
  "product":              142,
  "default_marking_code": "TS-F1",
  "marking_place": [
    {
      "id":      55,
      "code":   "F1",
      "name_pl": "Przód",
      "marking_option": [
        {
          "id":            201,
          "marking_code":  "TS-F1",
          "option_code":   "TS",          // kod techniki
          "price_code":    7,           // ID → /api/marking-price/
          "max_colors":    4,
          "realisation_time_id": 3,
          "marking_variant": []
        }
      ]
    }
  ],
  "additional_service": [
    { "service_id": "SETUP", "service_price_pln": "35.00" }
  ]
}

GET  /api/marking-price/?code=P3

// Odpowiedź:
{
  "id":   7,
  "code": "P3",
  "main_marking_price": [
    { "from_qty": 25,  "to_qty": 49,  "price_pln": "2.80" },
    { "from_qty": 50,  "to_qty": 99,  "price_pln": "2.20" },
    { "from_qty": 100, "to_qty": 249, "price_pln": "1.60" },
    { "from_qty": 250, "to_qty": 499, "price_pln": "1.10" }
  ]
}

GET  /api/my-prices/AP800001-01/?qty=100
Authorization: Bearer <token>

// Odpowiedź:
{
  "index":               "AP800001-01",
  "currency":            "PLN",
  "qty":                 100,
  "price":               "7.90",   // obowiązująca cena netto za sztukę
  "source":              "individual",   // base | discount | individual | promo
  "no_discount":         true,   // cena ostateczna
  "base_price":          "10.00",
  "discount_percent":    "10.00",
  "discounted_price":    "9.00",
  "individual_price":    "7.90",
  "promo_price":         null,
  "individual_tiers": [
    { "from_qty": 1,   "to_qty": 99,   "price": "8.40" },
    { "from_qty": 100, "to_qty": null, "price": "7.90" }
  ],
  "promo_tiers": []
}

GET  /api/promo-prices/                  // wszystkie obowiązujące promocje
GET  /api/promo-prices/ABC-123/          // jedna promocja po indeksie
GET  /api/promo-prices/?index=ABC-123,XYZ-007
Authorization: Bearer <token>

// Odpowiedź:
{
  "index":       "ABC-123",
  "active":      true,
  "date_from":   "2026-10-01",
  "date_to":     "2026-12-31",
  "is_current":  true,
  "no_discount": true,          // od tej ceny brak rabatu
  "tiers": [
    { "from_qty": 1,   "to_qty": 99,   "qty_label": "1–99",    "pln": "10.00", "eur": "2.40", "chf": null, "czk": null },
    { "from_qty": 100, "to_qty": null, "qty_label": "100+",    "pln": "8.50",  "eur": "2.05", "chf": null, "czk": null }
  ],
  "updated_at":  "2026-10-01T10:15:00+02:00"
}

GET  /api/promo-prices/ABC-123/price/?qty=150&currency=PLN

// Odpowiedź:
{
  "index":       "ABC-123",
  "qty":         150,
  "currency":    "PLN",
  "unit_price":  "8.50",
  "total":       "1275.00",
  "tier":        "100+",
  "no_discount": true
}

{
  "username":       "firma_abc",
  "email":          "biuro@firma.pl",
  "can_order":        true,           // false = POST /api/orders/ zwróci 403
  "discount_percent": 10.00,          // % rabatu na produkty z discount_prices=true
  "currency":         "PLN",          // waluta używana w zamówieniach
  "payment_method":   "banktransfer", // forma płatności w zamówieniach
  "language":         "pl"
}

POST /api/orders/
Authorization: Bearer <access_token>
Content-Type:  application/json

{
  // Twój własny numer zamówienia (opcjonalny)
  "client_reference": "MOJ-NR-2024/001",

  "notes": "Proszę o fakturę VAT",  // opcjonalne

  // Lista produktów — minimum jedna pozycja
  "items": [
    { "product_index": "ABC-123", "quantity": 50 },
    { "product_index": "XYZ-007", "quantity": 10 }
  ]
}

// Waluta i forma płatności z profilu użytkownika — nie trzeba podawać.

POST /api/orders/
Authorization: Bearer <token>
Content-Type:  application/json

{
  // ... pola zamawiającego i adresy ...

  "items": [
    {
      "product_index":      "20820-14",
      "quantity":           100,
      "marking_place_code": "M02",        // Tył
      "marking_option_code":"C1",         // DTF 60x50mm
      "marking_info":       "Logo firmowe, projekt w załączniku"
    },
    {
      "product_index":      "20820-14",
      "quantity":           50,
      "marking_place_code": "M02",
      "marking_option_code":"S1",         // Sitodruk 300x250mm
      "marking_colors":     2,            // max_colors=3
      "marking_info":       "Logo 2-kolorowe PMS"
    }
  ]
}

# Krok 1 — złóż zamówienie, zanotuj id zamówienia i id pozycji
# W odpowiedzi items[0].id = 99 (id pozycji)

# Krok 2 — wyślij plik projektu
curl -X POST https://developers.bluecollection.eu/api/orders/42/items/99/design \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@/sciezka/do/logo.pdf"

// Odpowiedź 201:
{
  "id":          7,
  "file":        "/media/order_item_designs/42/logo.pdf",
  "uploaded_at": "2026-06-25T11:30:00.000Z"
}

POST /api/orders/42/attachments/
Authorization: Bearer <token>
Content-Type:  multipart/form-data

// Pole formularza: file

// cURL:
curl -X POST https://developers.bluecollection.eu/api/orders/42/attachments/ \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@/path/to/wzor.pdf"

// Odpowiedź 201:
{
  "id":          1,
  "file":        "/media/order_attachments/2026/06/wzor.pdf",
  "uploaded_at": "2026-06-25T11:00:00.000Z"
}

GET  /api/orders/?status=new
Authorization: Bearer <token>