{"openapi":"3.1.0","info":{"title":"Закон · резерв законодавства","description":"Копія відкритих даних Мін’юсту. Редакція та чинність не вважаються підтвердженими лише через наявність копії. Bearer-ключі створюються у розділі «Доступ до API» після корпоративного входу.","version":"1.0.0"},"paths":{"/api/v1/me":{"get":{"tags":["Обліковий запис"],"summary":"Me","operationId":"me_api_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/status":{"get":{"tags":["Законодавство"],"summary":"Status","operationId":"status_api_v1_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/documents":{"get":{"tags":["Законодавство"],"summary":"Пошук за назвою або повним текстом","operationId":"search_api_v1_documents_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":300,"default":"","title":"Q"}},{"name":"mode","in":"query","required":false,"schema":{"enum":["title","all"],"type":"string","default":"title","title":"Mode"}},{"name":"number","in":"query","required":false,"schema":{"type":"string","maxLength":100,"default":"","title":"Number"}},{"name":"publisher","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Publisher"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","maxLength":100,"default":"","title":"Kind"}},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date To"}},{"name":"sort","in":"query","required":false,"schema":{"enum":["relevance","newest","oldest"],"type":"string","default":"relevance","title":"Sort"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/documents/{document_id}":{"get":{"tags":["Законодавство"],"summary":"Document","operationId":"document_api_v1_documents__document_id__get","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/documents/{document_id}/texts/{text_id}":{"get":{"tags":["Законодавство"],"summary":"Text","operationId":"text_api_v1_documents__document_id__texts__text_id__get","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}},{"name":"text_id","in":"path","required":true,"schema":{"type":"string","title":"Text Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","txt"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/documents/{document_id}/editions":{"get":{"tags":["Редакції та події"],"summary":"Editions","operationId":"editions_api_v1_documents__document_id__editions_get","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/events":{"get":{"tags":["Редакції та події"],"summary":"Events","operationId":"events_api_v1_events_get","parameters":[{"name":"date_from","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Date From"}},{"name":"date_to","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Date To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/history":{"get":{"tags":["Особисті дані"],"summary":"History","operationId":"history_api_v1_history_get","parameters":[{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Особисті дані"],"summary":"Record History","operationId":"record_history_api_v1_history_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoryInput"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Особисті дані"],"summary":"Clear History","operationId":"clear_history_api_v1_history_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/bookmarks":{"get":{"tags":["Особисті дані"],"summary":"Bookmarks","operationId":"bookmarks_api_v1_bookmarks_get","parameters":[{"name":"folder","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Folder"}},{"name":"document_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Document Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Особисті дані"],"summary":"Save Bookmark","operationId":"save_bookmark_api_v1_bookmarks_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookmarkInput"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/bookmark-folders":{"get":{"tags":["Особисті дані"],"summary":"Bookmark Folders","operationId":"bookmark_folders_api_v1_bookmark_folders_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/bookmarks/{bookmark_id}":{"delete":{"tags":["Особисті дані"],"summary":"Delete Bookmark","operationId":"delete_bookmark_api_v1_bookmarks__bookmark_id__delete","parameters":[{"name":"bookmark_id","in":"path","required":true,"schema":{"type":"string","title":"Bookmark Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/keys":{"get":{"tags":["Ключі API"],"summary":"Keys","operationId":"keys_api_v1_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["Ключі API"],"summary":"Create Key","operationId":"create_key_api_v1_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyInput"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/keys/{key_id}":{"delete":{"tags":["Ключі API"],"summary":"Revoke Key","operationId":"revoke_key_api_v1_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BookmarkInput":{"properties":{"document_id":{"type":"string","maxLength":64,"minLength":1,"title":"Document Id"},"folder":{"type":"string","maxLength":120,"title":"Folder","default":""},"note":{"type":"string","maxLength":4000,"title":"Note","default":""}},"type":"object","required":["document_id"],"title":"BookmarkInput"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HistoryInput":{"properties":{"kind":{"type":"string","enum":["search","view"],"title":"Kind"},"query":{"type":"string","maxLength":300,"title":"Query","default":""},"document_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Document Id"},"filters":{"additionalProperties":{"type":"string"},"type":"object","title":"Filters"}},"type":"object","required":["kind"],"title":"HistoryInput"},"KeyInput":{"properties":{"label":{"type":"string","maxLength":100,"minLength":1,"title":"Label"},"days":{"anyOf":[{"type":"integer","maximum":90.0,"minimum":1.0},{"type":"null"}],"title":"Days","description":"1–90 днів; null — без обмеження строку","default":30},"scopes":{"items":{"type":"string"},"type":"array","maxItems":3,"minItems":1,"title":"Scopes"}},"type":"object","required":["label"],"title":"KeyInput"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"zk_…"},"BrowserSession":{"type":"apiKey","in":"cookie","name":"__Host-zakon_session"}}},"security":[{"ApiKey":[]},{"BrowserSession":[]}]}