https://api.shtrafovnet.ru/latest/clients/
Для юридических лиц и индивидуальных предпринимателей имеющих свой автотранспорт, мы предоставляем услуги по массовой проверке и оплате штрафов (ГИБДД, АМПП, МАДИ и др).
Подробнее об условиях: https://b2b.shtrafovnet.ru/
Любой инструмент, умеющий работать с HTTP, может связываться с API просто путем формирования правильного URI. Запросы должны выполняться с использованием протокола HTTPS, чтобы трафик шифровался. Интерфейс реагирует на различные методы в зависимости от требуемого действия.
Мы используем кодировку UTF-8. Все данные необходимо передавать в формате JSON. Формат ответа, нами так же отправляется в формате JSON.
| Метод | Описание |
|---|---|
| GET |
Для простого извлечения информации о вашей учетной записи, транспортных средствах или информации о штрафах вам следует использовать метод GET. Запрошенная вами информация будет возвращена вам как объект JSON. Атрибуты, определенные объектом JSON, могут использоваться для формирования дополнительных запросов. Любой запрос с использованием метода GET доступен только для чтения и не влияет на какие-либо объекты, которые вы запрашиваете. |
| DELETE |
Чтобы уничтожить ресурс и удалить его из учетной записи, следует использовать метод DELETE. Это удалит указанный объект, если он будет найден. Если он не найден, операция вернет ответ, указывающий, что объект не найден. Эта идемпотентность означает, что вам не нужно проверять наличие ресурсов до вызова команды удаления, конечное состояние будет таким же, независимо от его существования. |
| PUT |
Для обновления информации о ресурсе в вашей учетной записи доступен метод PUT (должны быть переданы все данные объекта). Как и метод DELETE, метод PUT является идемпотентом. Он устанавливает состояние цели, используя предоставленные значения, независимо от их текущих значений. Запросы, используя метод PUT, не нужно проверять текущие атрибуты объекта. |
| POST |
Чтобы создать новый объект, в вашем запросе должен быть указан метод POST. Запрос POST включает в себя все атрибуты, необходимые для создания нового объекта. Если вы хотите создать новый объект, отправьте POST запрос на целевой URI. |
| PATCH |
Для обновления информации о ресурсе в вашей учетной записи доступен метод PATCH (необходимо передать только изменяемые поля). Отличие от метода PUT в том, что данный метод не изменяет полностью объект, а только пеерданные параметры. |
Когда запрос выполнен успешно, тело ответа обычно отправляется обратно в виде объекта JSON. Исключением является обработка запроса DELETE, который приведет к успешному состоянию HTTP 204 и пустому телу ответа.
{
"cars": [
{
"id": 123
"cert": "11AA123456"
. . .
},
{
"id": 234
"cert": "11BB123456"
. . .
}
]
}{
"id": 123
"cert": "11AA123456"
. . .
}Существует два разных способа передачи параметров в запросе с помощью API.
При передаче параметров для создания или обновления объекта параметры должны передаваться как объект JSON,
содержащий имена и значения соответствующих атрибутов в виде пар «ключ-значение». Когда вы используете этот
формат, вы должны указать, что вы отправляете объект JSON в заголовок. Это делается путем установки
заголовка Content-Type: application/json. Это гарантирует, что ваш
запрос
будет интерпретирован
правильно.
При передаче параметров для фильтрации ответа на запросы GET параметры могут передаваться с использованием
стандартных атрибутов запроса. В этом случае параметры будут встроены в URI, добавив ? в конце
URI, а затем установки каждого атрибута с помощью знака равенства. Атрибуты могут быть разделены символом
&.
curl -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"cert": "11AA123456", "reg": "а001аа777"}' \
-X POST "https://api.shtrafovnet.ru/v2/cars"curl -H "Authorization: Bearer $TOKEN" \
-X GET "https://api.shtrafovnet.ru/v2/cars/1234/fines?type=nopaid"Для методов управления аккаунтом , а так же для получения токена доступа используется
Basic-авторизация.
Для всех остальных запросов необходимо указывать заголовок
Authorization: Bearer $TOKEN содержащий полученный токен доступа.
curl -X $HTTP_METHOD -H 'Content-Type: application/json' \
-u '$EMAIL:$PASSWORD' \
$URL curl -X $HTTP_METHOD \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $TOKEN' \
$URL Чтобы максимально упростить интеграцию Shtrafovnet API, существуют официальные клиенты:
Если возникает ошибка, будь то на сервере или на стороне клиента, сообщения об ошибках будут возвращены в массиве ошибок.
Например:
400 Bad Request{
"status":400,
"type":"validation_error",
"title":"There was a validation error",
"errors":{
"name":[
"This value should not be blank."
],
"email":[
"Email address can not be empty",
"This value should not be blank."
],
"companyInn":[
"This value should not be blank."
],
"plainPassword":[
"This value should not be blank."
]
}
}Объект ссылки возвращается как часть тела ответа, когда включена разбивка на страницы.
По умолчанию для каждой страницы возвращается 200 объектов. Если ответ содержит 200 объектов или меньше, объект ссылок не будет возвращен.
Если ответ содержит более 200 объектов, первые 200 будут возвращены вместе с объектом ссылок.
Объект _links содержит содержит ключи, указывающие взаимосвязь
дополнительных
страниц. Значения
этих параметров - это URL-адреса связанных страниц. Ключи будут следующими:
self: URI текущей страницы результатов.first: URI первой страницы результатов.prev: URI предыдущей последовательной страницы результатов.next: URI следующей последовательной страницы результатов.last: URI последней страницы результатов.Параметры:
pages указывает на общее количество страниц результата запроса.
page указывает на текущую страницу результата запроса.total указывает на общее количество элементов результата запроса.
count указывает на количество элементов запроса на текущей
странице.
{
. . .
"pages": 10,
"page": 1,
"total": 2000,
"count": 200,
"_links": {
"self": "https://api.shtrafovnet.ru/v2/cars?page=1",
"first": "https://api.shtrafovnet.ru/v2/cars?page=1",
"next": "https://api.shtrafovnet.ru/v2/cars?page=2",
"last": "https://api.shtrafovnet.ru/v2/cars?page=3"
},
. . .
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/account'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "777",
"username": "User",
"email": "user@test.ru",
"status": "new",
"first_name": "Алексей",
"last_name": "Иванов",
"middle_name": "Петрович",
"phone": "79005551122",
"created_at": "2019-01-01 00:00:00",
"last_activity_at": "2019-01-01 00:00:00"
}Создание нового бизнес аккаунта.
После регистрации на указанную почту будет отправлено письмо с подтверждением.
Дальнейшая работа с API возможна только с подтвержденным аккаунтом.
curl --request POST \
--header 'Content-Type:application/json' \
--data '{"name":"Company Inc","phone":"79005551122","inn":"1234567890","fullname":"Алексей Петрович Иванов","email":"user@test.ru","password":"my_secret"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/account/registration'HTTP/1.1 201 Created
Content-Type:application/json
Location:https://api.shtrafovnet.ru/latest/clients/account
{
"id": "777",
"username": "User",
"email": "user@test.ru",
"status": "new",
"first_name": "Алексей",
"last_name": "Иванов",
"middle_name": "Петрович",
"phone": "79005551122",
"created_at": "2019-01-01 00:00:00",
"last_activity_at": "2019-01-01 00:00:00"
}curl --request POST \
--header 'Content-Type:application/json' \
--data '{"email":"user@test.ru"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/account/reset-password'HTTP/1.1 201 Created
Content-Type:application/json
{
"message": "New password sent to email"
}curl --request POST \
--header 'Content-Type:application/json' \
--data '{"email":"user@test.ru"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/account/reconfirm'HTTP/1.1 201 Created
Content-Type:application/json
{
"message": "Registration letter sent to your email"
}curl --request PATCH \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"password":"my_secret","last_name":"Иванов","first_name":"Алексей","middle_name":"Петрович","phone":"79005551122"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/account'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "777",
"username": "User",
"email": "user@test.ru",
"status": "new",
"first_name": "Алексей",
"last_name": "Иванов",
"middle_name": "Петрович",
"phone": "79005551122",
"created_at": "2019-01-01 00:00:00",
"last_activity_at": "2019-01-01 00:00:00"
}Создание нового токена доступа к ресурсам и услугам сервиса. Токен бессрочный, поэтому нет необходимости запрашивать его перед каждым запросом (положите его в кэш).
Проекту необходимо реализовать автоматическое получения нового токена в случае его невалидности, смены пароля от аккаунта и тд.
curl --request POST \
--header 'Authorization:Basic %base64-encoding of email:password%' \
--url 'https://api.shtrafovnet.ru/latest/clients/tokens'HTTP/1.1 201 Created
Content-Type:application/json
{
"token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXUyJ9.eyJpZCI6MTg1LCJpYXQiOiIxNDk3NDI5MTUzIn0.fKTZRbGGAEyn2eQbwgSx2FP4UOsC2XvMMw0dlw9qvfyraW725SyBEXqMCs1T9Gd5QaHrf9UBv-Qj6MJY23hpoUooQxDGrA-nX3c-ucF79hnaiPEBFVt6vvfeA8F4-ssOqs4s8ZWrufwARsw2JEN0i4XsVKo57N3P_Oh6TYOmECyUI22qAs2WQlJ585Rb4XKe_HXrwNVjP3rLyu2DLSYKjXPDvMh5Lt0wGZjI3LI2Zlr_ri1DxM41FM-7FuREv-zIFpzK6J-Scij-aInt2OA5nfjGt1b7KEtXLfjd6hYFO29h4nm_wSYmYbTgcYv5dwNSDHnDzSnx0nIQe5ZXxg_m3HiBke01SWhikA-ZDYORQstnrRJRer0nYK8BCZwl-SrRK0aOvO_wl0CaYDD5nigra6JWcKJVoNCDfvvYncp8ag_U6CoPzy-hIluBKEOrtWJotySeO1r_1NQuR5VDna8sqKRWtmFN9vwLx8cf_z2Y-9_gMmQmetQHdjd1lOwE0rLeuKmeppp8HcDKWlGASZRwivu3NCEtkWRmzxcvvFQEJkbjP6zmOSyVoeQOKc2P3lkJ4ou5XlTnx2U_Ga8nIwQOnJ5fnez2YQQ_60TrDWTawErTc2kf8qirtJdJD5UwY-ALqsWbau9pEXurDP8OwW-7m4blmBb9bVXpKSZkSCMwW4A"
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/company'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "9267",
"display_name": "Best Service",
"name": "Best Service Full",
"short_name": "BSC",
"url": "https:\/\/example.com",
"status": "active",
"notification_variable": "nopaid",
"created_at": "2019-01-01 00:00:00",
"address": "396005, г.Воронеж, ул.Ворошилова 123, д.23, офис 657",
"legal_address": "396005, г.Воронеж, ул.Ворошилова 123, д.23, офис 657",
"inn": "1234567890",
"kpp": "644901001",
"ogrn": "1026402000657",
"bank_bik": "044525225",
"bank_name": "ТОЧКА ПАО БАНКА \"ФК ОТКРЫТИЕ\" г. МОСКВА",
"bank_account": "ТОЧКА ПАО БАНКА \"ФК ОТКРЫТИЕ\" г. МОСКВА",
"bank_correspondent_account": "30101810400000000225",
"activity": "Лизинг",
"fullname": "Алексей Петрович Иванов",
"pay_commission": "4",
"serviceTest": "Флаг указывающий что аккаунт находится на тестовом периоде обслуживания",
"service_test": "Флаг указывающий что аккаунт находится на тестовом периоде обслуживания",
"current_service": {
"id": "1",
"started_at": "2019-01-01 00:00:00",
"ended_at": "2019-01-01 00:00:00",
"created_at": "2019-01-01 00:00:00",
"invoice_id": "3290",
"tariff_id": "10",
"is_current": "false",
"days_left": "2"
},
"service_enable": "Флаг указывающий что информационное обслуживание активно",
"service_days_left": "Флаг указывающий что информационное обслуживание заканчивается через N дней"
}curl --request PATCH \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"display_name":"Best Service","name":"Best Service Full","short_name":"BSC","kpp":"644901001","ogrn":"1026402000657","address":"396005, г.Воронеж, ул.Ворошилова 123, д.23, офис 657","legal_address":"396005, г.Воронеж, ул.Ворошилова 123, д.23, офис 657","activity":"Лизинг","url":"https:\/\/example.com","bank_name":"ТОЧКА ПАО БАНКА \"ФК ОТКРЫТИЕ\" г. МОСКВА","bank_bik":"044525225","bank_account":"ТОЧКА ПАО БАНКА \"ФК ОТКРЫТИЕ\" г. МОСКВА","bank_correspondent_account":"30101810400000000225","notification_variable":"nopaid","callback_url":"https:\/\/example.com\/postback\/shtrafovnet"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/company'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "9267",
"display_name": "Best Service",
"name": "Best Service Full",
"short_name": "BSC",
"url": "https:\/\/example.com",
"status": "active",
"notification_variable": "nopaid",
"created_at": "2019-01-01 00:00:00",
"address": "396005, г.Воронеж, ул.Ворошилова 123, д.23, офис 657",
"legal_address": "396005, г.Воронеж, ул.Ворошилова 123, д.23, офис 657",
"inn": "1234567890",
"kpp": "644901001",
"ogrn": "1026402000657",
"bank_bik": "044525225",
"bank_name": "ТОЧКА ПАО БАНКА \"ФК ОТКРЫТИЕ\" г. МОСКВА",
"bank_account": "ТОЧКА ПАО БАНКА \"ФК ОТКРЫТИЕ\" г. МОСКВА",
"bank_correspondent_account": "30101810400000000225",
"activity": "Лизинг",
"fullname": "Алексей Петрович Иванов",
"pay_commission": "4",
"serviceTest": "Флаг указывающий что аккаунт находится на тестовом периоде обслуживания",
"service_test": "Флаг указывающий что аккаунт находится на тестовом периоде обслуживания",
"current_service": {
"id": "1",
"started_at": "2019-01-01 00:00:00",
"ended_at": "2019-01-01 00:00:00",
"created_at": "2019-01-01 00:00:00",
"invoice_id": "3290",
"tariff_id": "10",
"is_current": "false",
"days_left": "2"
},
"service_enable": "Флаг указывающий что информационное обслуживание активно",
"service_days_left": "Флаг указывающий что информационное обслуживание заканчивается через N дней"
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/stat'HTTP/1.1 200 OK
Content-Type:application/json
{
"stat": 25
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars?status=new&cert=4619689062®=%D0%B0001%D0%B0%D0%B0777&name=Nissan+Tiida'HTTP/1.1 200 OK
Content-Type:application/json
{
"total": 1,
"count": 1,
"_links": "https:\/\/api.shtrafovnet.ru\/latest\/clients\/cars?page=1",
"cars": {
"id": "1212",
"name": "NISSAN TIIDA",
"driverLicense": "00aa000222",
"reg": "a001aa777",
"cert": "3620848236",
"status": "active",
"inactiveReason": "data_incorrect",
"scannedAt": "2019-01-01 00:00:00",
"gisScannedAt": "2019-01-01 00:00:00",
"gibddScannedAt": "2019-01-01 00:00:00",
"ditScannedAt": "2019-01-01 00:00:00",
"createdAt": "2019-01-01 00:00:00",
"companyId": "1",
"user": "user@test.ru",
"verifyGibddStatus": "new",
"finesCount": "10",
"finesAmount": "1000"
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/:id'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "1212",
"name": "Ford Focus 2 2006",
"reg": "a001aa777",
"cert": "3620848236",
"status": "new",
"inactiveReason": "data_incorrect",
"gisScannedAt": "2019-01-01 00:00:00",
"gibddScannedAt": "2019-01-01 00:00:00",
"ditScannedAt": "2019-01-01 00:00:00",
"createdAt": "2019-01-01 00:00:00",
"companyId": "1",
"finesCount": "10",
"finesAmount": "1000"
}curl --request POST \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"cert":"3620848236","reg":"a001aa777","name":"Ford Focus 2 2006"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars'HTTP/1.1 201 Created
Content-Type:application/json
Location:https://api.shtrafovnet.ru/latest/clients/cars/:id
{
"id": "1212",
"name": "Ford Focus 2 2006",
"reg": "a001aa777",
"cert": "3620848236",
"status": "new",
"inactiveReason": "data_incorrect",
"gisScannedAt": "2019-01-01 00:00:00",
"gibddScannedAt": "2019-01-01 00:00:00",
"ditScannedAt": "2019-01-01 00:00:00",
"createdAt": "2019-01-01 00:00:00",
"companyId": "1",
"finesCount": "10",
"finesAmount": "1000"
}Обновление данных о транспортном средстве.
Данный метод позволяет изменить только необходимые поля не передавая всю информацию о транспортном средстве.
По религиозным соображениям изменение СТС и госномера, а так же ВУ не допускается, но вы можете удалить ТС и добавить новое.
curl --request PATCH \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"name":"Ford Focus 2 2006"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/:id'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "1212",
"name": "Ford Focus 2 2006",
"reg": "a001aa777",
"cert": "3620848236",
"status": "new",
"inactiveReason": "data_incorrect",
"gisScannedAt": "2019-01-01 00:00:00",
"gibddScannedAt": "2019-01-01 00:00:00",
"ditScannedAt": "2019-01-01 00:00:00",
"createdAt": "2019-01-01 00:00:00",
"companyId": "1",
"finesCount": "10",
"finesAmount": "1000"
}curl --request DELETE \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/:id'HTTP/1.1 204 No Content
curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--data '{"car_ids":["1","2"]}' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/actions/flush_inactive'HTTP/1.1 200 OK
Content-Type:application/json
{
"message": "The status of inactive cars is reset"
}curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--data '{"car_ids":["1","2"]}' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/actions/remove_inactive'HTTP/1.1 200 OK
Content-Type:application/json
{
"message": "Inactive cars removed"
}curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--data '{"car_ids":["1","2"]}' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/actions/archive'HTTP/1.1 200 OK
Content-Type:application/json
{
"message": "Cars added to the archive"
}curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--data '{"car_ids":["1","2"]}' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/actions/unarchive'HTTP/1.1 200 OK
Content-Type:application/json
{
"message": "Cars removed from the archive"
}curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/actions/export?status=new&cert=3620848236®=a001aa777&name=Nissan+Tiida'HTTP/1.1 200 OK
Content-Type:application/json
{
"response": "https:\/\/shtrafovnet-dev.s3.eu-west-1.amazonaws.com\/clients\/aab3238922bcc25a6f606eb525ffdc56\/export\/cars\/2019\/02\/22\/cars_export_14_20190222134430.xlsx"
}curl --request POST \
--header 'Content-Type:text/csv | application/json | application/vnd.ms-excel' \
--header 'Authorization:Bearer $TOKEN' \
--data '$content' \
--url 'https://api.shtrafovnet.ru/latest/clients/cars/actions/load'HTTP/1.1 200 OK
Content-Type:application/json
{
"import": {
"added": [],
"updated": [],
"error": [],
"double": []
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/fields'HTTP/1.1 200 OK
Content-Type:application/json
{
"total": 1,
"count": 1,
"_links": "https:\/\/api.shtrafovnet.ru\/latest\/clients\/fields?page=1",
"fields": {
"code": "anycode",
"description": "anydescription"
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/fields/:code'HTTP/1.1 200 OK
Content-Type:application/json
{
"code": "anycode",
"description": "anydescription"
}curl --request POST \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"code":"anycode","description":"anydescription"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/fields'HTTP/1.1 201 Created
Content-Type:application/json
Location:https://api.shtrafovnet.ru/latest/clients/fields/:id
{
"code": "anycode",
"description": "anydescription"
}curl --request PATCH \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"description":"anydescription"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/fields/:code'HTTP/1.1 200 OK
Content-Type:application/json
{
"code": "anycode",
"description": "anydescription"
}curl --request DELETE \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/fields/:code'HTTP/1.1 204 No Content
curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/fines?paid=na&status=active&cars=200&fines=200&uins=12345678901234567890&uin_search=1234567&doc=sts&org=gibdd&filters=new&started=2019-01-22&ended=2019-02-22&create_started=2019-01-16&create_ended=2019-01-16&update_started=2019-01-16&update_ended=2019-01-16'HTTP/1.1 200 OK
Content-Type:application/json
{
"total": 1,
"count": 1,
"_links": "https:\/\/api.shtrafovnet.ru\/latest\/clients\/fines?page=1",
"fines": {
"id": "1",
"postNumber": "18810136161108008161",
"name": null,
"postedAt": "2019-01-01",
"amount": "500",
"actuallyPaidAmount": null,
"actuallyPaidAt": "2019-01-01 00:00:00",
"createdAt": "2019-01-01 00:00:00",
"discountDate": "2019-01-01 23:59:59",
"discountSize": "50",
"wireKbk": "18811630020016000140",
"wireUsername": "УФК по Воронежской обл. (ГУ МВД России по Воронежской области)",
"wireOktmo": "20701000",
"wireBankBik": "042007001",
"wireBankAccount": "40101810500000010004",
"wireBankName": "Отделение по Воронежской области ГУ ЦБ РФ по ЦФО (Отделение Воронеж)",
"wireKpp": "366601001",
"wireInn": "3666026374",
"location": null,
"locationLat": null,
"locationLong": null,
"koapCode": "12.9ч.2",
"enablePics": "true",
"loadPics": "1",
"violationAt": "2019-01-01 00:00:00",
"isGis": "true",
"isGibdd": "true",
"isDit": "true",
"isUin": "true",
"status": "check",
"inactiveReason": "another_car",
"pics": {
"url": "https:\/\/s3.eu-central-1.amazonaws.com\/shtrafovnetru\/pics\/2017\/02\/14\/09\/cad29d806521c20c9f2aeb98d5ec5445.jpg"
},
"docType": "sts",
"docNumber": "3620848239",
"docViolator": null,
"updatedAt": "2019-01-01 00:00:00",
"updatedMask": "0011",
"fsspIp": "",
"fsspUin": "",
"isPaidMarked": "",
"isPaid": "true",
"paidStatus": "paid",
"koapText": "",
"isExpired": "true",
"expiredDays": "",
"penaltyDate": "2019-01-01 23:59:59",
"discountDaysLeft": "0",
"isDiscount": "false",
"totalAmount": "500",
"car": "1003726",
"carName": "KIA OPTIMA",
"carCert": "3620848239",
"carReg": "р668хо36",
"whoseOrg": "gibdd",
"paymentOrderUrl": "https:\/\/shtrafovnet.ru\/payment_report?operation_id=12345&uin=1880000000000001",
"divisionName": "Центр видеофиксации ГИБДД ГУ МВД России по Воронежской области",
"divisionCode": "1120951",
"paidAmount": "0.00"
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/fines/:id'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "1",
"postNumber": "18810136161108008161",
"postedAt": "2019-01-01",
"amount": "500",
"actuallyPaidAt": "2019-01-01 00:00:00",
"createdAt": "2019-01-01 00:00:00",
"discountDate": "2019-01-01 23:59:59",
"discountSize": "50",
"wireKbk": "18811630020016000140",
"wireUsername": "УФК по Воронежской обл. (ГУ МВД России по Воронежской области)",
"wireOktmo": "20701000",
"wireBankBik": "042007001",
"wireBankAccount": "40101810500000010004",
"wireBankName": "Отделение по Воронежской области ГУ ЦБ РФ по ЦФО (Отделение Воронеж)",
"wireKpp": "366601001",
"wireInn": "3666026374",
"koapCode": "12.9ч.2",
"enablePics": "true",
"loadPics": "1",
"violationAt": "2019-01-01 00:00:00",
"isGis": "true",
"isGibdd": "true",
"isDit": "true",
"isUin": "true",
"status": "check",
"inactiveReason": "another_car",
"pics": "https:\/\/s3.eu-central-1.amazonaws.com\/shtrafovnetru\/pics\/2017\/02\/14\/09\/cad29d806521c20c9f2aeb98d5ec5445.jpg",
"docType": "sts",
"docNumber": "3620848239",
"updatedAt": "2019-01-01 00:00:00",
"updatedMask": "0011",
"paidStatus": "paid",
"isExpired": "true",
"penaltyDate": "2019-01-01 23:59:59",
"isDiscount": "false",
"totalAmount": "500",
"car": "1003726",
"carName": "KIA OPTIMA",
"carCert": "3620848239",
"carReg": "р668хо36",
"whoseOrg": "gibdd",
"divisionName": "Центр видеофиксации ГИБДД ГУ МВД России по Воронежской области",
"divisionCode": "1120951",
"paidAmount": "0.00"
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/fines/:id/card'HTTP/1.1 200 OK
Content-Type:application/pdf
curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/fines/:id/1c'HTTP/1.1 200 OK
Content-Disposition:$disposition
curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--data '{"fine_ids":["2","3"]}' \
--url 'https://api.shtrafovnet.ru/latest/clients/fines/actions/mark-paid'HTTP/1.1 200 OK
Content-Type:application/json
{
"message": "All fines are marked as paid"
}curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/fines/actions/export'HTTP/1.1 201 Created
Content-Type:application/json
Location:https://api.shtrafovnet.ru/latest/clients/actions/export/:id
{
"task": "2019-01-22 00:00:00"
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/fines/actions/export/:id'HTTP/1.1 200 OK
Content-Type:application/json
{
"response": "2019-01-22 00:00:00"
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/drivers/stat'HTTP/1.1 200 OK
Content-Type:application/json
{
"stat": {
"all": 1000,
"new": 500,
"active": 100,
"inactive": 100,
"inactive_not_found": 100,
"inactive_expired": 100,
"inactive_deprived": 100
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/drivers?status=new&inactive_reason=new&name=22+AA+222222'HTTP/1.1 200 OK
Content-Type:application/json
{
"total": 1,
"count": 1,
"_links": "https:\/\/api.shtrafovnet.ru\/latest\/clients\/drivers?page=1",
"drivers": {
"id": "b731072a-f7f7-421f-b970-e44b2a6577e3",
"license": [
{}
],
"last_name": "Иванов",
"first_name": "Иван",
"middle_name": "Иванович",
"created_at": "2019-01-01 00:00:00",
"company_id": "9210",
"user_id": "9120"
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/drivers/:id'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "b731072a-f7f7-421f-b970-e44b2a6577e3",
"license": {
"id": "b731072a-f7f7-421f-b970-e44b2a6577e3",
"number": "22AA222222",
"issue_date": "2019-01-01",
"status": "new",
"inactive_reason": "not_found",
"expiration_date": "2019-01-01",
"birthday": "2019-01-01",
"categories": null,
"decisions": null,
"checked_at": "2019-01-01 00:00:00",
"created_at": "2019-01-01 00:00:00"
},
"last_name": "Иванов",
"first_name": "Иван",
"middle_name": "Иванович",
"created_at": "2019-01-01 00:00:00",
"company_id": "9210",
"user_id": "9120"
}curl --request POST \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"license_number":"00AA000000","license_issue_date":"2000-07-01","last_name":"Иванов","first_name":"Иван","middle_name":"Иванович"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/drivers'HTTP/1.1 201 Created
Content-Type:application/json
Location:https://api.shtrafovnet.ru/latest/clients/drivers/:id
{
"id": "b731072a-f7f7-421f-b970-e44b2a6577e3",
"license": {
"id": "b731072a-f7f7-421f-b970-e44b2a6577e3",
"number": "22AA222222",
"issue_date": "2019-01-01",
"status": "new",
"inactive_reason": "not_found",
"expiration_date": "2019-01-01",
"birthday": "2019-01-01",
"categories": null,
"decisions": null,
"checked_at": "2019-01-01 00:00:00",
"created_at": "2019-01-01 00:00:00"
},
"last_name": "Иванов",
"first_name": "Иван",
"middle_name": "Иванович",
"created_at": "2019-01-01 00:00:00",
"company_id": "9210",
"user_id": "9120"
}curl --request PATCH \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"last_name":"Иванов","first_name":"Иван","middle_name":"Иванович"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/drivers/:id'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "b731072a-f7f7-421f-b970-e44b2a6577e3",
"license": {
"id": "b731072a-f7f7-421f-b970-e44b2a6577e3",
"number": "22AA222222",
"issue_date": "2019-01-01",
"status": "new",
"inactive_reason": "not_found",
"expiration_date": "2019-01-01",
"birthday": "2019-01-01",
"categories": null,
"decisions": null,
"checked_at": "2019-01-01 00:00:00",
"created_at": "2019-01-01 00:00:00"
},
"last_name": "Иванов",
"first_name": "Иван",
"middle_name": "Иванович",
"created_at": "2019-01-01 00:00:00",
"company_id": "9210",
"user_id": "9120"
}curl --request DELETE \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/drivers/:id'HTTP/1.1 204 No Content
curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/drivers/:id/actions/flush'HTTP/1.1 200 OK
Content-Type:application/json
{
"message": "The status of a driver's license reset and sent to double-check"
}curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/drivers/actions/export?status=new&inactive_reason=new&name=22+AA+222222'HTTP/1.1 200 OK
Content-Type:application/json
{
"response": "https:\/\/shtrafovnet-dev.s3.eu-west-1.amazonaws.com\/clients\/aab3238922bcc25a6f606eb525ffdc56\/export\/drivers\/2019\/02\/22\/drivers_export_14_20190222134430.xlsx"
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/tariffs'HTTP/1.1 200 OK
Content-Type:application/json
{
"total": 1,
"count": 1,
"_links": "https:\/\/api.shtrafovnet.ru\/latest\/clients\/tariffs?page=1",
"tariffs": {
"id": "1",
"min_cars": "10",
"max_cars": "20",
"scan_period": "day",
"price": "4500",
"price_per_car": "4500"
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/services'HTTP/1.1 200 OK
Content-Type:application/json
{
"total": 1,
"count": 1,
"_links": "https:\/\/api.shtrafovnet.ru\/latest\/clients\/services?page=1",
"services": {
"id": "1",
"started_at": "2019-01-01 00:00:00",
"ended_at": "2019-01-01 00:00:00",
"created_at": "2019-01-01 00:00:00",
"invoice_id": "3290",
"tariff_id": "10",
"is_current": "false",
"days_left": "2"
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/services/:id'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "1",
"started_at": "2019-01-01 00:00:00",
"ended_at": "2019-01-01 00:00:00",
"created_at": "2019-01-01 00:00:00",
"invoice_id": "3290",
"tariff_id": "10",
"is_current": "false",
"days_left": "2"
}curl --request POST \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"tariff_id":"10","months":"1"}' \
--url 'https://api.shtrafovnet.ru/latest/clients/services'HTTP/1.1 201 Created
Content-Type:application/json
Location:https://api.shtrafovnet.ru/latest/clients/services/:id
{
"id": "996",
"number": "ИО-00597",
"comment": "ИО-00597",
"price": "4675",
"status": "done",
"created_at": "2019-01-10",
"paid_at": "2019-01-10",
"items": {
"name": "Информационное обслуживание за ООО \\\"Best Company\\\". Ежедневная проверка штрафов ГИБДД (11-50 ТС)",
"price": "5500",
"quantity": "1",
"discount": "15",
"tax": "0",
"unit": "month",
"total_price": "4675"
},
"pdf_url": "https:\/\/s3-eu-west-1.amazonaws.com\/shtrafovnet\/payment\/invoices\/2017\/06\/12\/142338_20170612_invoice_*****.pdf"
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/registries?status=new'HTTP/1.1 200 OK
Content-Type:application/json
{
"total": 1,
"count": 1,
"_links": "https:\/\/api.shtrafovnet.ru\/latest\/clients\/registries?page=1",
"registries": {
"id": "900",
"status": "new",
"amount": "500",
"commission": "4",
"totalAmount": "0",
"createdAt": "2019-01-01 00:00:00",
"items": [
{}
],
"invoice": "null",
"pdfUrl": "null",
"archiveUrl": ""
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/registries/:id'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "900",
"status": "new",
"amount": "500",
"commission": "4",
"createdAt": "2019-01-01 00:00:00",
"items": {
"uin": "18810136161108008161",
"postedAt": "2019-01-01",
"amount": "500",
"description": "",
"quittance": "",
"username": "УФК по Воронежской обл. (ГУ МВД России по Воронежской области)",
"inn": "1234567890",
"kpp": "644901001",
"kbk": "18210101011013000110",
"bank": "Отделение по Воронежской области ГУ ЦБ РФ по ЦФО (Отделение Воронеж)",
"bik": "042007001",
"oktmo": "20701000",
"account": "40101810500000010004",
"status": "new",
"createdAt": "2019-01-01 00:00:00",
"paidAt": "2019-01-01 00:00:00",
"checkedAt": "2019-01-01 00:00:00",
"confirmedAt": "2019-01-01 00:00:00",
"inactiveReason": "",
"discountAt": "2019-01-01 23:59:59",
"discountSize": "50",
"payAmount": "",
"fine": "",
"pdfUrl": ""
},
"invoice": "null",
"pdfUrl": "null"
}Создание реестра штрафов для проверки (на возможность оплаты) и последующей оплаты через сервис ШтрафовНет.ру
После проверки рееста, вы получите на электронную почту сообщение о результате проверки. После ознакомления с резальтатами необходимо выставить счет.
После того, как счет будет оплачен, в автоматическом режиме начнется оплата выбранных постановлений.
curl --request POST \
--header 'Content-Type:application/json' \
--header 'Authorization:Bearer $TOKEN' \
--data '{"uins":["18810136161108008161"]}' \
--url 'https://api.shtrafovnet.ru/latest/clients/registries'HTTP/1.1 201 Created
Content-Type:application/json
Location:https://api.shtrafovnet.ru/latest/clients/registries/:id
{
"id": "900",
"status": "new",
"amount": "500",
"commission": "4",
"createdAt": "2019-01-01 00:00:00",
"items": {
"uin": "18810136161108008161",
"postedAt": "2019-01-01",
"amount": "500",
"description": "",
"quittance": "",
"username": "УФК по Воронежской обл. (ГУ МВД России по Воронежской области)",
"inn": "1234567890",
"kpp": "644901001",
"kbk": "18210101011013000110",
"bank": "Отделение по Воронежской области ГУ ЦБ РФ по ЦФО (Отделение Воронеж)",
"bik": "042007001",
"oktmo": "20701000",
"account": "40101810500000010004",
"status": "new",
"createdAt": "2019-01-01 00:00:00",
"paidAt": "2019-01-01 00:00:00",
"checkedAt": "2019-01-01 00:00:00",
"confirmedAt": "2019-01-01 00:00:00",
"inactiveReason": "",
"discountAt": "2019-01-01 23:59:59",
"discountSize": "50",
"payAmount": "",
"fine": "",
"pdfUrl": ""
},
"invoice": "null",
"pdfUrl": "null"
}curl --request DELETE \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/registries/:id'HTTP/1.1 204 No Content
curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/registries/:id/actions/bill'HTTP/1.1 201 Created
Content-Type:application/json
{
"id": "996",
"number": "ИО-00597",
"comment": "ИО-00597",
"price": "4675",
"status": "done",
"created_at": "2019-01-10",
"paid_at": "2019-01-10",
"items": {
"name": "Информационное обслуживание за ООО \\\"Best Company\\\". Ежедневная проверка штрафов ГИБДД (11-50 ТС)",
"price": "5500",
"quantity": "1",
"discount": "15",
"tax": "0",
"unit": "month",
"total_price": "4675"
},
"pdf_url": "https:\/\/s3-eu-west-1.amazonaws.com\/shtrafovnet\/payment\/invoices\/2017\/06\/12\/142338_20170612_invoice_*****.pdf"
}curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--data '{"uins":["18810136161108008114"]}' \
--url 'https://api.shtrafovnet.ru/latest/clients/registries/:id/actions/add-items'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "900",
"status": "new",
"amount": "500",
"commission": "4",
"createdAt": "2019-01-01 00:00:00",
"items": {
"uin": "18810136161108008161",
"postedAt": "2019-01-01",
"amount": "500",
"description": "",
"quittance": "",
"username": "УФК по Воронежской обл. (ГУ МВД России по Воронежской области)",
"inn": "1234567890",
"kpp": "644901001",
"kbk": "18210101011013000110",
"bank": "Отделение по Воронежской области ГУ ЦБ РФ по ЦФО (Отделение Воронеж)",
"bik": "042007001",
"oktmo": "20701000",
"account": "40101810500000010004",
"status": "new",
"createdAt": "2019-01-01 00:00:00",
"paidAt": "2019-01-01 00:00:00",
"checkedAt": "2019-01-01 00:00:00",
"confirmedAt": "2019-01-01 00:00:00",
"inactiveReason": "",
"discountAt": "2019-01-01 23:59:59",
"discountSize": "50",
"payAmount": "",
"fine": "",
"pdfUrl": ""
},
"invoice": "null",
"pdfUrl": "null"
}curl --request POST \
--header 'Authorization:Bearer $TOKEN' \
--data '{"uins":["18810136161108008161"]}' \
--url 'https://api.shtrafovnet.ru/latest/clients/registries/:id/actions/remove-items'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "900",
"status": "new",
"amount": "500",
"commission": "4",
"createdAt": "2019-01-01 00:00:00",
"items": {
"uin": "18810136161108008161",
"postedAt": "2019-01-01",
"amount": "500",
"description": "",
"quittance": "",
"username": "УФК по Воронежской обл. (ГУ МВД России по Воронежской области)",
"inn": "1234567890",
"kpp": "644901001",
"kbk": "18210101011013000110",
"bank": "Отделение по Воронежской области ГУ ЦБ РФ по ЦФО (Отделение Воронеж)",
"bik": "042007001",
"oktmo": "20701000",
"account": "40101810500000010004",
"status": "new",
"createdAt": "2019-01-01 00:00:00",
"paidAt": "2019-01-01 00:00:00",
"checkedAt": "2019-01-01 00:00:00",
"confirmedAt": "2019-01-01 00:00:00",
"inactiveReason": "",
"discountAt": "2019-01-01 23:59:59",
"discountSize": "50",
"payAmount": "",
"fine": "",
"pdfUrl": ""
},
"invoice": "null",
"pdfUrl": "null"
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/invoices?status=new'HTTP/1.1 200 OK
Content-Type:application/json
{
"total": 1,
"count": 1,
"_links": "https:\/\/api.shtrafovnet.ru\/latest\/clients\/invoices?page=1",
"invoices": {
"id": "996",
"number": "ИО-00597",
"comment": "ИО-00597",
"price": "4675",
"status": "done",
"created_at": "2019-01-10",
"paid_at": "2019-01-10",
"items": [
{}
],
"pdf_url": "https:\/\/s3-eu-west-1.amazonaws.com\/shtrafovnet\/payment\/invoices\/2017\/06\/12\/142338_20170612_invoice_*****.pdf"
}
}curl --request GET \
--header 'Authorization:Bearer $TOKEN' \
--url 'https://api.shtrafovnet.ru/latest/clients/invoices/:id'HTTP/1.1 200 OK
Content-Type:application/json
{
"id": "996",
"number": "ИО-00597",
"comment": "ИО-00597",
"price": "4675",
"status": "done",
"created_at": "2019-01-10",
"paid_at": "2019-01-10",
"items": {
"name": "Информационное обслуживание за ООО \\\"Best Company\\\". Ежедневная проверка штрафов ГИБДД (11-50 ТС)",
"price": "5500",
"quantity": "1",
"discount": "15",
"tax": "0",
"unit": "month",
"total_price": "4675"
},
"pdf_url": "https:\/\/s3-eu-west-1.amazonaws.com\/shtrafovnet\/payment\/invoices\/2017\/06\/12\/142338_20170612_invoice_*****.pdf"
}