Список доверенностей

POST {host}/psp/poas/

ЗАПРОС

Заголовок

{
    "Accept-Language": "ru", // ○ язык ответов: ru или en (ru по-умолчанию)
    "Authorization": "Bearer {token}" // ● JWT токен авторизации
}

Структура

Метод не требует тела запроса

ОТВЕТ

Структура

{
    "poas": [ // Список доверенностей
        {
            "uuid": string, // UUID доверенности
            "participant": { // Информация о компании-участнике
                "id": integer, // ID компании
                "uuid": string, // UUID компании в системе Честного знака
                "name": string, // Название компании
                "inn": string // ИНН компании
            },
            "start_at": string, // Дата начала действия доверенности (ISO 8601)
            "end_at": string, // Дата окончания действия доверенности (ISO 8601)
            "revoked_at": string | null, // Дата отзыва доверенности или null (ISO 8601)
            "permissions": dict, // Разрешения доверенности
            "state": string // Состояние доверенности (справочник POA_STATE)
        }
    ]
}

💡 Значение state - справочная информация, которую можно получить через раздел Справочники (POA_STATE).

Пример

{
    "poas": [
        {
            "uuid": "123e4567-e89b-12d3-a456-426614174000",
            "participant": {
                "id": 123,
                "uuid": "550e8400-e29b-41d4-a716-446655440000",
                "name": "ООО 'Ромашка'",
                "inn": "1234567890"
            },
            "start_at": "2024-01-01T00:00:00Z",
            "end_at": "2024-12-31T23:59:59Z",
            "revoked_at": null,
            "permissions": {},
            "state": "ACTIVE"
        },
        {
            "uuid": "223e4567-e89b-12d3-a456-426614174001",
            "participant": {
                "id": 124,
                "uuid": "660e8400-e29b-41d4-a716-446655440001",
                "name": "АО 'Технологии'",
                "inn": "0987654321"
            },
            "start_at": "2024-02-01T00:00:00Z",
            "end_at": "2024-11-30T23:59:59Z",
            "revoked_at": "2024-06-15T10:30:00Z",
            "permissions": {},
            "state": "REVOKED"
        }
    ]
}

ОШИБКИ

💡 Метод также может возвращать глобальные ошибки.

ПРИМЕЧАНИЯ

1. Метод требует аутентификации пользователя через JWT токен
2. Доступен только для пользователей, привязанных к сервис-провайдеру
3. Возвращает список доверенностей, выданных текущему сервис-провайдеру