{
  "id": "dataset--sanctions-registry",
  "kind": "explainer",
  "title": "Державний реєстр санкцій: API та довідники",
  "jurisdiction": "UA",
  "language": "uk",
  "version": "0.8.0",
  "publication": "draft",
  "evidence": "unverified",
  "implementation": "not-assessed",
  "effective": {
    "from": null,
    "to": null,
    "checkedAt": null
  },
  "citations": [],
  "rights": {
    "status": "unknown",
    "note": "Original editorial reference material with source links; third-party artifact redistribution is not authorized by this release."
  },
  "content": {
    "legacyKind": "dataset",
    "kind": "Джерело нормативних або реєстрових даних",
    "reviewedAt": "2026-09-17",
    "links": [
      {
        "label": "Результат перевірки доступу · JSON",
        "url": "https://lad-oblik.botpartners.workers.dev/data/sanctions-access-check.json"
      }
    ],
    "formats": [
      "JSON API",
      "CSV / XLSX експорту"
    ],
    "auth": "Документація передбачає x-cota-public-api-key у заголовку або cotaApiKey у query. Пропозиція: передавати ключ із сервера в заголовку.",
    "providerUpdates": "За змінами у джерелі. Гарантований інтервал публікації не встановлено.",
    "refreshAdvice": "Пропозиція: стежити за новими указами через документований /actions/new-decrees; перевіряти потрібного суб’єкта перед рішенням. Частоту узгодити з умовами доступу.",
    "verification": "2026-09-17 за київським часом переглянуто OpenAPI та виконано GET /dictionaries/restrictions без ключа: HTTP 401, Api Key is not provided. Доступ із ключем і відповіді з даними не перевірені.",
    "extract": [
      "Отримати доступ у видавця; перевірити схему та ліміти потрібного методу.",
      "Окремо отримувати довідники типів та записи суб’єктів. Код типу і конкретна санкційна дія є різними об’єктами.",
      "Зберігати ID суб’єкта, указ, строки обмеження, історію та час перевірки."
    ],
    "conceptIds": [
      "contractor",
      "register"
    ],
    "relatedIds": [
      "edr",
      "country-codes"
    ],
    "id": "sanctions-registry",
    "name": "Державний реєстр санкцій: API та довідники",
    "group": "Сторони й перевірки",
    "publisher": "Апарат РНБО України",
    "sourceUrl": "https://api-drs.nsdc.gov.ua/swagger/",
    "summary": "Суб’єкти, санкційні дії, види обмежень та історія. API документований; проба довідника без ключа повернула 401.",
    "access": "Swagger описує GET /v2/subjects, історію дій і /dictionaries/restrictions, /dictionaries/identifiers, /dictionaries/countries, /dictionaries/decrees. Старий /subjects/{subjectType} позначений застарілим.",
    "keys": [
      "sid у просторі реєстру",
      "ID / тип обмеження + указ + період"
    ],
    "pitfalls": [
      "Збіг імені є кандидатом на перевірку, а не встановленою тотожністю.",
      "401 або збій мережі не означає відсутності санкцій.",
      "Довідник країн цього реєстру має власне охоплення; це не повна заміна ISO 3166."
    ],
    "limits": "Ключ не надано; ліміти, умови масового отримання та поширення не встановлені."
  },
  "relationships": [],
  "history": [],
  "provenance": {
    "project": "oblik-map",
    "endpoint": "/api/export#dataCatalog",
    "originalId": "sanctions-registry",
    "sourceHash": "1b8256e22fbaf6fa213a0e654df7b741e185ecd0dafa7d9bc69e490902df02bb",
    "edition": {
      "version": "0.8.0",
      "updated": "2026-09-17",
      "jurisdiction": "UA",
      "language": "uk",
      "origin": "Codex",
      "review": "Редакційна версія. Фахову перевірку правил ще не завершено."
    }
  },
  "uncertainty": "AI-assisted editorial snapshot. Human review is not recorded; source links and legacy reviewedAt do not certify current law or applicability."
}