Запрос служит для получения данных о доступных профилях владельца ключей. SIM-карта может содержать несколько ключей, каждый из которых связан с так называемым профилем владельца ключа. Набор полей в профиле может варьироваться и зависит выбранного поставщика услуг мобильной электронной подписи.

Ниже представлены примеры профилей, которое используются в решениях операторов Lifecell и Vodafone. 

URL-адрес запроса

https://ccs-dev-api.cipher.kiev.ua/ccs/api/v1/mssp/{msspId}/profiles

Метод

PUT

Параметры запроса
msspIdString

Идентификатор ПУМЭП.

Может быть получен с использованием запроса Получение списка поддерживаемых ПУМЭП

Настраиваемые заголовки запроса
Content-Typeapplication/json
Параметры JSON объекта запроса
ИмяТипОписаниеДопустимые значения
phoneNumberStringНомер телефонаСтрока с номером телефона, который связан с SIM-картой, данные профилей владельца ключей которой необходимо получить
Ответ
Код ответаContent-typeДопустимые параметрыПример содержимого
200application/jsonArray
[
    {
        "organization": "Арт-простір",
        "title": "Тамада",
        "positionId": 4505,
        "serviceId": "SIGN_DSTU_DEPUTY"
    },
    {
        "organization": "",
        "title": "Default",
        "positionId": 4504,
        "serviceId": "SIGN_DSTU"
    }
]
400application/jsonmessage
{
    "message" : "Краткое описание ошибки." 
}
500application/jsonmessage
failureCause 
{
    "message" : "Краткое описание ошибки.",
    "failureCause" : "Дополнительная информация, детали, значения параметров, которые относятся к ошибке"
}
Параметры JSON объекта ответа
Параметр
Тип данных
Описание
messageStringОписание результата проведения операции
ArrayArrayМассив профилей владельца ключей
failureCauseString

Дополнительная информация об ошибке:

  • дополнительное описание
  • значения параметров и переменных
  • текстовое описание исключения
  • "stack trace" исключения в случае отсутствия у него текстового описания
  • другие данные, которые могут идентифицировать ошибку

Наличие всех, одного или нескольких типов дополнительной информации в поле "failureCause" необязательно.

Поля элемента Массив профилей владельца ключей

Поле
Тип данных
Описание
organizationStringНазвание организации
titleStringНазвание профиля
positionIdStringИдентификатор должности владельца профиля
serviceString

Идентификатор сервиса, который связан с выработкой электронной подписи.

Для решений Lifecell и Vodafone допустимыми значениями идентификатора сервиса при необходимости выработки электронной подписи с использованием национальных криптоалгоритмов являются:

  • SIGN_DSTU_DEPUTY
  • SIGN_DSTU

Профили со значениями идентификатора сервиса, которые отличны от указанных выше, не включаются в ответ.