{
    "openapi": "3.1.0",
    "info": {
        "title": "Цифровой паспорт компании API (digitalpassport.by)",
        "version": "1.0.0",
        "description": "Публичный API проверяемых цифровых паспортов белорусских организаций для ИИ-агентов, поисковых систем и внешних интеграций."
    },
    "servers": [
        {
            "url": "https://digitalpassport.by"
        }
    ],
    "paths": {
        "/api/v1/companies": {
            "get": {
                "operationId": "searchBelarusCompanies",
                "summary": "Поиск компаний по названию, УНП, городу или рубрике",
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Поисковый запрос (название компании, бренд или 9 цифр УНП)"
                    },
                    {
                        "name": "city",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Фильтр по городу (например, Минск, Брест, Гродно)"
                    },
                    {
                        "name": "category",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Слаг отраслевой рубрики"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Список найденных паспортов компаний"
                    }
                }
            }
        },
        "/api/v1/companies/{identifier}": {
            "get": {
                "operationId": "getCompanyPassport",
                "summary": "Получить полный цифровой паспорт компании по 9-значному УНП или слагу",
                "parameters": [
                    {
                        "name": "identifier",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "9 цифр УНП (например, 693300245) или слаг карточки (например, 693300245-dadrio)"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Полный структурированный цифровой паспорт со ссылками на первоисточники и графом Schema.org"
                    },
                    "404": {
                        "description": "Организация не найдена"
                    }
                }
            }
        }
    }
}