API сертификаты КЭП

Электронная подпись — цифровой аналог собственноручной подписи, предназначенный для защиты документа от внесения несанкционированных изменений и для подтверждения авторства.

Электронный документ, подписанный ЭП, имеет такую же юридическую значимость, как и подписанный от руки и скреплённый печатью. Его примут арбитражный суд, ФНС и другие государственные органы.

Содержание

1. Подтверждение аккаунта с помощью сертификата КЭП
2. Регистрация сертификата КЭП ИП в системе ЭПД
3. Получение данных сертификатов из указанного списка ID (отпечатков) сертификатов
4. Получение сертификатов авторизованного пользователя

Подтверждение аккаунта с помощью сертификата КЭП

Балл за подтверждение аккаунта показывает другим участникам, что вы реальная фирма или реальный человек, и открывает больше возможностей по работе на ATI.SU. Метод также выполняет проверку подписи.

Подтверждение аккаунта с помощью сертификата КЭП

post /gw/sign_checker/v4/verify-account-by-signature

Модель и примеры

Запрос

Пример запроса

CURL

curl 'https://api.ati.su/gw/sign_checker/v4/verify-account-by-signature' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: multipart/form-data; boundary=boundary'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/sign_checker/v4/verify-account-by-signature");

Ответ

204 Successful Response

Модель

null

Пример

null

422 Validation Error

Модель

{...}

detail:[{...}]

loc*: [enum]

[string, integer]

msg*: string

type*: string

}]

}

Пример

{...}

"detail":[...]

{...}

"loc":[...],

"string"

],

"msg":"string",

"type":"string"

}

]

}

Консоль

Отправить

Параметры

verify_signature true false Флаг для проверки подписи

signature

Регистрация сертификата КЭП ИП в системе ЭПД

Запускает подключение ИП к системе оператора ЭПД с указанием адреса регистрации.

Примечание: подключение ЮЛ к системе ЭПД происходит в фоновом режиме при проверке подписи.

Регистрация сертификата ИП в системе ЭПД

post /gw/sign_checker/v4/certificates/{certificate_id}/registration

Модель и примеры

Запрос

Модель

{...}

postcode: string (nullable)

Почтовый индекс

region_id*: integer

Идентификатор региона

district: string (nullable)

Район

city: string (nullable)

Город

locality: string (nullable)

Населенный пункт

street: string (nullable)

Улица

house: string (nullable)

Дом

apartment: string (nullable)

Квартира

housing: string (nullable)

Корпус

}

Пример запроса

CURL

curl 'https://api.ati.su/gw/sign_checker/v4/certificates/{certificate_id}/registration' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"postcode":"^\\d{6}$","region_id":0,"district":"^[^,]*$","city":"^[^,]*$","locality":"^[^,]*$","street":"string","house":"string","apartment":"string","housing":"string"}'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/sign_checker/v4/certificates/{certificate_id}/registration", "{""postcode"":""^\\d{6}$"",""region_id"":0,""district"":""^[^,]*$"",""city"":""^[^,]*$"",""locality"":""^[^,]*$"",""street"":""string"",""house"":""string"",""apartment"":""string"",""housing"":""string""}");

Ответ

200 Successful Response

Модель

{missing-type-info}

Пример

null

422 Validation Error

Модель

{...}

detail:[{...}]

loc*: [enum]

[string, integer]

msg*: string

type*: string

}]

}

Пример

{...}

"detail":[...]

{...}

"loc":[...],

"string"

],

"msg":"string",

"type":"string"

}

]

}

Консоль

Отправить

Параметры

certificate_id ID (отпечаток) сертификата

{ "postcode": "^\\d{6}$", "region_id": 0, "district": "^[^,]*$", "city": "^[^,]*$", "locality": "^[^,]*$", "street": "string", "house": "string", "apartment": "string", "housing": "string" }

Получение данных сертификатов из указанного списка ID (отпечатков) сертификатов

Возрвщает данные сертификатов из указанного в запросе списка ID (отпечатков).

Получение данных сертификатов

get /gw/sign_checker/v4/certificates

Модель и примеры

Запрос

Пример запроса

CURL

curl 'https://api.ati.su/gw/sign_checker/v4/certificates' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/gw/sign_checker/v4/certificates");

Ответ

200 Список сертификатов

Модель

[{...}]

id*: string

body*: string

components*:{...}

any-key: string

}

issuer*:{...}

any-key: string

}

serial*: string

title*: string

valid_from*: string

valid_until*: string

meta*:{...}

revoked*: boolean

created_at*: date-time

}

}]

Пример

[...]

{...}

"id":"string",

"body":"string",

"components":{...},

"any-key":"string"

},

"issuer":{...},

"any-key":"string"

},

"serial":"string",

"title":"string",

"valid_from":"string",

"valid_until":"string",

"meta":{...}

"revoked":false,

"created_at":"1970-01-01T00:00:00.000Z"

}

}

]

422 Validation Error

Модель

{...}

detail:[{...}]

loc*: [enum]

[string, integer]

msg*: string

type*: string

}]

}

Пример

{...}

"detail":[...]

{...}

"loc":[...],

"string"

],

"msg":"string",

"type":"string"

}

]

}

Консоль

Отправить

Параметры

certificate_ids Список ID (отпечатков) сертификатов

Получение сертификатов авторизованного пользователя

Возвращает все сертификаты (и их данные) авторизованного пользователя, указанного в headers запроса.

Получение сертификатов авторизованного пользователя

get /gw/sign_checker/v4/firms/current-user/certificates

Модель и примеры

Запрос

Пример запроса

CURL

curl 'https://api.ati.su/gw/sign_checker/v4/firms/current-user/certificates' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/gw/sign_checker/v4/firms/current-user/certificates");

Ответ

200 Сертификаты авторизованного пользователя

Модель

[{...}]

id*: string

body*: string

components*:{...}

any-key: string

}

issuer*:{...}

any-key: string

}

serial*: string

title*: string

valid_from*: string

valid_until*: string

meta*:{...}

revoked*: boolean

created_at*: date-time

}

}]

Пример

[...]

{...}

"id":"string",

"body":"string",

"components":{...},

"any-key":"string"

},

"issuer":{...},

"any-key":"string"

},

"serial":"string",

"title":"string",

"valid_from":"string",

"valid_until":"string",

"meta":{...}

"revoked":false,

"created_at":"1970-01-01T00:00:00.000Z"

}

}

]

Консоль

Отправить

Параметры

Нет параметров