Skip to content
Podatkovni model

Enotna struktura vsebine

Partner pošlje dogodek v tej obliki ali pa platforma pretvori njegovo obstoječo obliko prek preslikave polj. Ključ za zaznavanje sprememb je par source.system_id + source.external_id.

Uvoz dogodka (partner → platforma)

PUT /api/v1/ingest/contents/kd-maribor/evt-4471
{
  "type": "event",
  "language": "sl",
  "title": "Koncert godalnega kvarteta",
  "description": "…",
  "starts_at": "2026-11-14T19:30:00+01:00",
  "ends_at": "2026-11-14T21:00:00+01:00",
  "location": {
    "name": "Sinagoga Maribor",
    "address": "Židovska ulica 4, 2000 Maribor",
    "country": "SI", "lat": 46.5571, "lng": 15.6467
  },
  "organizer": { "name": "…", "url": "…" },
  "categories_external": ["glasba/klasična"],
  "media": [{ "type": "image", "url": "https://…/kvartet.jpg" }],
  "url": "https://partner.si/dogodki/4471",
  "price": { "free": false, "text": "15 €" },
  "updated_at": "2026-10-20T08:12:00Z"
}

Feed za ciljnega partnerja (platforma → partner)

GET /api/v1/outbound/feed?lang=de&updated_since=…
{
  "items": [{
    "delivery_id": "dlv_8f2c",
    "content_id": "cnt_19ab",
    "version": 3,
    "language": "de",
    "translated": true,
    "translation_status": "approved",
    "title": "Konzert des Streichquartetts",
    "categories": ["musik.klassik"],
    "source": {
      "partner": "KD Maribor",
      "system_id": "kd-maribor",
      "external_id": "evt-4471",
      "original_language": "sl",
      "url": "https://partner.si/dogodki/4471"
    },
    "action": "upsert"
  }],
  "next_cursor": "eyJpZCI6…"
}

Statusi distribucije

pending→ translating→ ready→ delivered→ published ·failedrejectedwithdrawn

Ciljni sistem potrdi prevzem z POST /outbound/acks, kjer sporoči svoj ID in URL objave. Tako je vidna sledljivost od originala do objavljene različice.