← Maailma andmed

Kontrolli ostupüha

GET /shopping/check

Kontrollige, kas täna on konkreetses riigis ostlemispüha või sooduskampaania. Tagastab tõeväärtuse tulemuse koos sündmuse üksikasjadega, kui see on aktiivne. Kasulik automaatsete soodusbännerite käivitamiseks, käimasolevate pakkumiste kohta tõuketeavituste saatmiseks ning hinnastrateegiate kohandamiseks suurte ostlemissündmuste ajal nagu Black Friday.

Parameetrid

country kohustuslik

Country

Näidispäringud

Põhikasutus
curl "https://nordapi.ee/api/v1/shopping/check?country=US"
Check US shopping holidays today
curl "https://nordapi.ee/api/v1/shopping/check?country=US"
Check Chinese shopping holidays today
curl "https://nordapi.ee/api/v1/shopping/check?country=CN"
Check UK shopping holidays today
curl "https://nordapi.ee/api/v1/shopping/check?country=GB"

Reaalajas vastus 

{
  "active_events": [
    {
      "category": "seasonal",
      "countries": [
        "US",
        "CA",
        "GB",
        "DE",
        "FR"
      ],
      "date": "2026-08-01",
      "days_until": 0,
      "description": "Extended shopping season. Electronics, clothing, school supplies, dorm furnishings.",
      "duration_days": 45,
      "end_date": "2026-09-14",
      "id": "back_to_school",
      "impact": "high",
      "is_active": true,
      "name": "Back to School",
      "status": "active_now"
    }
  ],
  "country": "US",
  "date": "2026-09-03",
  "days_until_next": -33,
  "is_shopping_holiday": true,
  "next_event": {
    "category": "seasonal",
    "countries": [
      "US",
      "CA",
      "GB",
      "DE",
      "FR"
    ],
    "date": "2026-08-01",
    "days_until": 0,
    "description": "Extended shopping season. Electronics, clothing, school supplies, dorm furnishings.",
    "duration_days": 45,
    "end_date": "2026-09-14",
    "id": "back_to_school",
    "impact": "high",
    "is_active": true,
    "name": "Back to School",
    "status": "active_now"
  },
  "success": true
}
← Tagasi: Maailma andmed