Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
...
Схема взаємодії Клієнта з Серверами черги
Gliffy Diagram | ||||||
---|---|---|---|---|---|---|
|
Загальна інформація щодо роботи із запитами
Всі запити мають бути у форматі'POST'
. Content-type:application/json
Запити:
GetOrganisations()
Expand | |
---|---|
|
...
|
...
| |
Цей запит використовується для отримання списку організацій. Він вимагає аутентифікацію за допомогою токену і підтримує багатомовність через |
...
параметр URLМетод
Параметри запитуЗапит має включати тіло з двома параметрами:
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням |
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetOrganisations \
-H "Content-Type: application/json" \
-d '{
"authToken":"11111111-abcd-dead-beef-0123456789",
"languageId":1
}' |
Приклад відповіді
Code Block | ||
---|---|---|
| ||
{
"OrganisationList": [
{
"OrgTypeId": 1,
"OrgTypeDescription": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ",
"Code": 240,
"LocationId": 1,
"GeoInfo": {
"CityId": 47,
"City": "Первомайське",
"RegionId": 1,
"Region": "АР Крим",
"CountryId": 1,
"Country": "Україна",
"Address": "ул. Пушкина"
},
"OrganisationId": 1,
"OrganisationName": "test"
},
{
"OrgTypeId": 1,
"OrgTypeDescription": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ",
"Code": 240,
"LocationId": 1,
"GeoInfo": {
"CityId": 47,
"City": "Первомайське",
"RegionId": 1,
"Region": "АР Крим",
"CountryId": 1,
"Country": "Україна",
"Address": "ул. Пушкина"
},
"OrganisationId": 2,
"OrganisationName": "Volia"
}
],
"ReturnInfo": {
"ReturnCode": 0,
"ReturnSubcode": 0,
"ReturnMessage": "OK"
}
} |
Опис полів
Property | Data type | Description |
---|---|---|
ServiceCenterId | int | ID сервісного центру |
ServiceCenterName | string | Назва сервісного центру |
OrganisationId | int | ID організації |
RegistrationDaysLimit | int | Ліміт кількості днів для попередньої реєстрації |
Sop | datetime | Дата, з якої дозволено попередню реєстрацію |
GeoInfo.CityId | int | ID міста |
GeoInfo.City | string | Назва міста |
GeoInfo.RegionId | int | ID регіону (області) |
GeoInfo.Region | string | Назва регіону (області) |
GeoInfo.CountryId | int | ID країни |
GeoInfo.Country | string | Назва країни |
GeoInfo.Address | string | Адреса організації |
ReturnInfo | об'єкт ReturnInfo | Інформація про результати виконання |
Цей запит використовується для отримання списку організацій.
GetServiceCenters()
Expand | |
---|---|
|
...
|
...
Цей запит використовується для отримання списку сервісних центрів. URL
|
Параметр | Тип даних | Обов'язковість | Опис |
---|---|---|---|
authToken |
...
|
...
|
...
Тіло Запиту
|
...
Приклад запиту з використанням |
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetOrganisations \
-H "Content-Type: application/json" \
-d '{
"authToken":"11111111-abcd-dead-beef-0123456789",
"organisationId":2,
"languageId":1
}' |
Приклади відповіді
Code Block | ||
---|---|---|
| ||
{
"ServiceCenterList": [
{
"ServiceCenterId": 1,
"ServiceCenterName": "ЦНАП м. Києва",
"GeoInfo": {
"CityId": 472,
"City": "Київ",
"RegionId": 11,
"Region": "Київ",
"CountryId": 1,
"Country": "Україна",
"Address": "вул. Дніпровська набережна, 19-Б"
},
"OrganisationId": 3,
"RegistrationDaysLimit": 60,
"Sop": "2024-01-25T00:00:00"
},
{
"ServiceCenterId": 2,
"ServiceCenterName": "ЦНАП Подільської РДА",
"GeoInfo": {
"CityId": 472,
"City": "Київ",
"RegionId": 11,
"Region": "Київ",
"CountryId": 1,
"Country": "Україна",
"Address": "вул. Костянтинівська, 9/6"
},
"OrganisationId": 2,
"RegistrationDaysLimit": 30,
"Sop": "2024-01-25T00:00:00"
}
],
"ReturnInfo": {
"ReturnCode": 0,
"ReturnSubcode": 0,
"ReturnMessage": "OK"
}
} |
Опис полів відповіді
Property | Data type | Description |
---|---|---|
ServiceCenterId | int | ID сервісного центру |
ServiceCenterName | string | Назва сервісного центру |
OrganisationId | int | ID організації |
RegistrationDaysLimit | int | Ліміт кількості днів для попередньої реєстрації |
Sop | datetime | Дата, з якої дозволена попередня реєстрація |
GeoInfo.CityId | int | ID міста |
GeoInfo.City | string | Назва міста |
GeoInfo.RegionId | int | ID регіону (області) |
GeoInfo.Region | string | Назва регіону (області) |
GeoInfo.CountryId | int | ID країни |
GeoInfo.Country | string | Назва країни |
GeoInfo.Address | string | Адреса організації |
ReturnInfo | об'єкт ReturnInfo | Інформація про результати виконання |
Цей запит використовується для отримання списку сервісних центрів.
GetCities()
Expand | |
---|---|
|
...
|
...
Цей запит використовується для отримання списку міст. URL |
Параметр | Тип даних |
---|
...
|
...
Тіло запиту
Приклад запиту з використанням |
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetCities \
-H "Content-Type: application/json" \
-d '{
"authToken": "11111111-abcd-dead-beef-0123456789",
"languageId": "1"
}' |
Приклад відповіді
Успішна відповідь поверне JSON об'єкт зі списком міст та інформацією про результат виконання. Приклад структури відповіді:
Code Block | ||
---|---|---|
| ||
{
"CityList": [
{
"CityId": 404,
"City": "Івано-Франківськ",
"RegionId": 9,
"Region": "Івано-Франківська область",
"CountryId": 1,
"Country": "Україна",
"Address": ""
},
{
"CityId": 349,
"City": "Ужгород",
"RegionId": 7,
"Region": "Закарпатська область",
"CountryId": 1,
"Country": "Україна",
"Address": ""
}
],
"ReturnInfo": {
"ReturnCode": 0,
"ReturnSubcode": 0,
"ReturnMessage": "OK"
}
} |
Опис полів відповіді
Property | Data type | Description |
---|---|---|
CityId | int | ID міста |
City | string | Назва міста |
RegionId | int | ID регіону (області) |
Region | string | Назва регіону (області) |
CountryId | int | ID країни |
Country | string | Назва країни |
Address | string | Адреса організації |
ReturnInfo | об'єкт ReturnInfo | Інформація про результати виконання |
Цей запит використовується для отримання списку міст.
GetOrganisationsByCityId()
Expand | |
---|---|
|
...
|
...
Цей запит використовується для отримання списку організацій для вказаного міста. URL |
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням |
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetOrganisationsByCityId \
-H "Content-Type: application/json" \
-d '{
"authToken": "11111111-abcd-dead-beef-0123456789",
"cityId": 549,
"languageId": "1"
}' |
Приклад відповіді
Успішна відповідь поверне JSON об'єкт зі списком організацій та інформацією про результат виконання. Приклад структури відповіді:
Code Block |
---|
{
"OrganisationList": [
{
"OrgTypeId": 31,
"OrgTypeDescription": "ДЕРЖАВНА ОРГАНІЗАЦІЯ (УСТАНОВА, ЗАКЛАД)",
"Code": 425,
"LocationId": 1,
"GeoInfo": {
"CityId": 549,
"City": "Буськ",
"RegionId": 14,
"Region": "Львівська область",
"CountryId": 1,
"Country": "Україна",
"Address": ""
},
"OrganisationId": 9,
"OrganisationName": "Державна реєстрація актів цивільного стану"
}
],
"ReturnInfo": {
"ReturnCode": 0,
"ReturnSubcode": 0,
"ReturnMessage": "OK"
}
} |
Опис полів відповіді
Property | Data type | Description |
---|---|---|
OrganisationId | int | ID організації |
OrganisationName | string | Назва організації |
OrgTypeId | int | ID типу організації |
OrgTypeDescription | string | Назва типу організації |
Code | int | Код організації |
LocationId | int | ID локації |
GeoInfo.CityId | int | ID міста |
GeoInfo.City | string | Назва міста |
GeoInfo.RegionId | int | ID регіону (області) |
GeoInfo.Region | string | Назва регіону (області) |
GeoInfo.CountryId | int | ID країни |
GeoInfo.Country | string | Назва країни |
GeoInfo.Address | string | Адреса організації |
ReturnInfo | об'єкт ReturnInfo | Інформація про результати виконання |
Цей запит використовується для отримання списку організацій для вказаного міста.
GetServiceCentersByOrgAndCityId()
Expand | |
---|---|
|
...
|
...
Цей запит використовується для отримання списку сервісних центрів для вказаної організації в певному місті. URL |
Параметр |
---|
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням |
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetServiceCentersByOrgAndCityId \
-H "Content-Type: application/json" \
-d '{
"authToken": "11111111-abcd-dead-beef-0123456789",
"organisationId": 9,
"cityId": 549,
"languageId": "1"
}' |
Приклад відповіді
Успішна відповідь поверне JSON об'єкт зі списком сервісних центрів та інформацією про результат виконання. Приклад структури відповіді:
Code Block |
---|
{
"ServiceCenterList": [
{
"ServiceCenterId": 37,
"ServiceCenterName": "Буський міський відділ ДРАЦ",
"GeoInfo": {
"CityId": 549,
"City": "Буськ",
"RegionId": 14,
"Region": "Львівська область",
"CountryId": 1,
"Country": "Україна",
"Address": "вул. Петрушевича, 12"
},
"OrganisationId": 9,
"RegistrationDaysLimit": 30,
"Sop": "2024-01-26T00:00:00"
}
],
"ReturnInfo": {
"ReturnCode": 0,
"ReturnSubcode": 0,
"ReturnMessage": "OK"
}
} |
Опис полів відповіді
Property | Data type | Description |
---|---|---|
ServiceCenterId | int | ID сервісного центру |
ServiceCenterName | string | Назва сервісного центру |
OrganisationId | int | ID організації |
RegistrationDaysLimit | int | Ліміт кількості днів для попередньої реєстрації |
Sop | datetime | Дата, з якої дозволена попередня реєстрація |
GeoInfo.CityId | int | ID міста |
GeoInfo.City | string | Назва міста |
GeoInfo.RegionId | int | ID регіону (області) |
GeoInfo.Region | string | Назва регіону (області) |
GeoInfo.CountryId | int | ID країни |
GeoInfo.Country | string | Назва країни |
GeoInfo.Address | string | Адреса організації |
ReturnInfo | об'єкт ReturnInfo | Інформація про результати виконання |
Цей запит використовується для отримання списку сервісних центрів для вказаної організації в певному місті.
GetServiceCentersByService()
Expand | |
---|---|
|
...
|
...
Цей запит використовується для отримання списку сервісних центрів, які надають вказану послугу в заданому часовому інтервалі. URL |
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Примітка: Тіло запиту
Приклад запиту з використанням
Успішна відповідь поверне JSON об'єкт зі списком сервісних центрів та інформацією про результат виконання. Приклад структури відповіді:
Опис полів відповіді
Логіка обробки запиту
|
Цей запит використовується для отримання списку сервісних центрів, які надають вказану послугу в заданому часовому інтервалі.
GetAllGroups()
Expand | |
---|---|
|
...
|
...
Цей запит отримує список всіх груп послуг для вказаного сервісного центру і організації. URL |
Параметр | Тип даних | Опис |
---|---|---|
authToken |
...
|
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
Успішна відповідь поверне JSON об'єкт зі списком груп послуг та інформацією про результат виконання. Приклад структури відповіді:
Опис полів відповіді
|
Цей запит отримує список всіх груп послуг для вказаного сервісного центру і організації.
GetGroupsByParentId()
Expand | |
---|---|
|
...
|
...
Цей запит повертає список груп послуг для вказаної батьківської групи. URL |
...
|
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням |
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetGroupsByParentId \
-H "Content-Type: application/json" \
-d '{
"authToken": "11111111-abcd-dead-beef-0123456789",
"organisationId": 2,
"serviceCenterId": 1,
"parentGroupId": 0,
"languageId": 1
}' |
Приклад відповіді
Успішна відповідь поверне JSON об'єкт зі списком груп послуг та інформацією про результат виконання. Приклад структури відповіді:
Code Block |
---|
{
"GroupList": [
{
"GroupId": 204,
"ParentGroupId": 0,
"Description": "ID картка та закордонний паспорт",
"OrderWeight": 4
},
{
"GroupId": 230,
"ParentGroupId": 0,
"Description": "Отримати готовий документ",
"OrderWeight": 902
}
],
"ReturnInfo": {
"ReturnCode": 0,
"ReturnSubcode": 0,
"ReturnMessage": "OK"
}
} |
Опис полів відповіді
Property | Data type | Description |
---|---|---|
GroupId | int | ID групи |
ParentGroupId | int | ID батьківської групи |
Description | string | Опис групи |
OrderWeight | int | Ваговий коефіцієнт для сортування |
ReturnInfo | об'єкт ReturnInfo | Інформація про результати виконання |
Цей запит повертає список груп послуг для вказаної батьківської групи.
GetAllServices()
Expand | |
---|---|
|
...
|
...
Цей запит отримує список всіх послуг для вказаного сервісного центру і організації. URL |
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням |
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetAllServices \
-H "Content-Type: application/json" \
-d '{
"authToken": "11111111-abcd-dead-beef-0123456789",
"organisationId": 2,
"serviceCenterId": 1,
"languageId": 1
}' |
Приклад відповіді
Успішна відповідь поверне JSON об'єкт зі списком послуг та інформацією про результат виконання. Приклад структури відповіді:
Code Block |
---|
{
"ServiceList": [
{
"ServiceId": 870,
"GroupId": 204,
"Description": "Подати документи щодо оформлення ID картки та закордонного паспортa",
"OrderWeight": 835
},
{
"ServiceId": 872,
"GroupId": 0,
"Description": "Отримати готовий документ (крім id картки та закордонного паспорту)",
"OrderWeight": 837
}
],
"ReturnInfo": {
"ReturnCode": 0,
"ReturnSubcode": 0,
"ReturnMessage": "OK"
}
} |
Опис полів відповіді
Property | Data type | Description |
---|---|---|
ServiceId | int | ID послуги |
GroupId | int | ID групи, до якої належить послуга |
Description | string | Опис послуги |
OrderWeight | int | Ваговий коефіцієнт для сортування |
ReturnInfo | Объект ReturnInfo | Інформація про результати виконання |
Цей запит отримує список всіх послуг для вказаного сервісного центру і організації.
GetServicesByGroupId()
Expand | |
---|---|
|
...
|
...
Цей запит отримує список послуг для вказаної групи послуг. URL |
Параметр | Тип даних | Обов'язковість | Опис |
---|---|---|---|
authToken |
...
|
...
|
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
Приклад відповідіУспішна відповідь поверне JSON об'єкт зі списком послуг та інформацією про результат виконання. Приклад структури відповіді:
Опис полів відповіді
|
Цей запит отримує список послуг для вказаної групи послуг.
GetServicesByServiceCenter()
Expand | |
---|---|
|
...
|
...
Цей запит отримує перелік послуг, які надаються вказаним сервісним центром/центрами. URL |
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
Успішна відповідь поверне JSON об'єкт зі списком послуг та інформацією про результат виконання. Приклад структури відповіді:
Опис полів відповіді
Логіка обробки запиту
|
Цей запит отримує перелік послуг, які надаються вказаним сервісним центром/центрами.
GetServiceIdByTypeId()
Expand | |
---|---|
|
...
|
...
Цей запит отримує |
...
ідентифікатор послуги відповідно до її типу. URL |
...
|
...
Запит має включати тіло з трьох параметрів:
authToken
(Guid): Токен авторизації.organisationId
(int): Ідентифікатор організації.languageId
(int): Ідентифікатор мови.
Тіло запиту
|
...
|
...
|
...
|
...
|
...
Приклад запиту з використанням |
Code Block |
---|
curl -X POST "https://{HOST}/api/servicehub/ |
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Параметри запитуЗапит має включати тіло з чотироьх параметрів:
Приклад відповіді Успішна відповідь поверне JSON об'єкт зі списком |
...
послуг та інформацією про результат виконання. Приклад структури відповіді:
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Опис полів відповіді
|
...
|
...
|
...
|
...
|
...
Цей запит отримує
...
ідентифікатор послуги відповідно до її типу.
GetServiceTypesByOrgId()
Expand | |
---|---|
|
...
|
...
Цей запит отримує список |
...
типів послуг для заданої організації |
...
. URL |
...
|
...
|
...
|
...
Тіло запиту
|
...
Приклад запиту з використанням
|
...
|
...
Приклад |
...
відповіді Успішна відповідь поверне JSON об'єкт зі списком |
...
типів послуг та інформацією про результат виконання. Приклад структури відповіді:
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Опис |
...
полів |
...
відповіді
|
...
|
...
|
Цей запит отримує список
...
типів послуг для заданої організації
...
.
GetCustomerTypes()
Expand | |
---|---|
|
...
|
...
Цей запит отримує список груп клієнтів для заданої організації та сервісного центру. URL |
...
|
Параметр | Тип даних | Обов'язковість | Опис |
---|---|---|---|
authToken |
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
|
...
Успішна відповідь поверне JSON об'єкт зі списком груп клієнтів та інформацією про результат виконання. Приклад структури відповіді:
|
...
Цей запит отримує список груп клієнтів для заданої організації та сервісного центру.
GetCustomerTypesForOrganisation()
Expand | |
---|---|
|
...
|
...
Цей запит отримує список |
...
груп клієнтів для заданої організації. URL |
...
|
...
трьох параметрів: |
...
|
...
|
...
...
|
...
|
...
Тіло запиту
|
...
|
...
Приклад запиту з використанням
|
Приклад запиту з використанням curl
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Приклад |
...
відповіді Успішна відповідь поверне JSON об'єкт зі списком |
...
груп клієнтів та інформацією про результат виконання. Приклад структури відповіді:
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Опис полів відповіді
|
Цей запит отримує список груп клієнтів для заданої організації.
GetDays()
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Цей запит отримує список днів, в які доступна попередня реєстрація для вказаної послуги. URL |
Параметр | Тип даних | Обов'язковість | Опис |
---|---|---|---|
authToken | Guid | Токен авторизації. | |
organisationId | int | ID організації. | |
serviceCenterId | int | IDсервісного центру. | |
serviceId | int | ID послуги. | |
startDay | datetime | Початкова дата. | |
stopDay | datetime | Кінцева дата. |
Тіло запиту
Code Block |
---|
{
"authToken":"11111111-abcd-dead-beef-0123456789",
"organisationId": 1,
"serviceCenterId": 1,
"serviceId": 1,
"startDay":"2024-03-17",
"stopDay":"2024-03-18"
} |
Приклад запиту з використанням curl
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetDays \
-H "Content-Type: application/json" \
-d '{
"authToken": "11111111-abcd-dead-beef-0123456789",
"organisationId": 1,
"serviceCenterId": 1,
"serviceId": 1,
"startDay": "2024-03-17",
"stopDay": "2024-03-18"
}' |
Приклад відповіді
Успішна відповідь поверне JSON об'єкт зі списком днів та інформацією про результат виконання. Приклад структури відповіді:
Code Block |
---|
{
"Days": [
{
"DatePart": "2024-01-27T00:00:00",
"IsAllow": 0,
"Exclude": 0,
"StartTime": "09:00:00",
"StopTime": "17:45:00",
"ScheduleBreak": 0,
"StartBreak": "13:00:00",
"StopBreak": "13:45:00",
"CountJobs": 0,
"CountJobsAllow": 0
},
{
"DatePart": "2024-01-28T00:00:00",
"IsAllow": 0,
"Exclude": 1,
"StartTime": "08:55:00",
"StopTime": "21:00:00",
"ScheduleBreak": 0,
"StartBreak": "00:00:00",
"StopBreak": "00:00:00",
"CountJobs": 0,
"CountJobsAllow": 0
}
],
"ReturnInfo": {
"ReturnCode": 0,
"ReturnSubcode": 0,
"ReturnMessage": "OK"
}
} |
Опис полів відповіді
Property | Data type | Description |
---|---|---|
DatePart | datetime | Дата |
IsAllow | int | Признак дозволеної реєстрації |
Exclude | int | Признак недоступності дати для реєстрації |
StartTime | datetime | Початок дня |
StopTime | datetime | Кінець дня |
ScheduleBreak | bool | Признак наявності перерви |
StartBreak | datetime | Початок перерви |
StopBreak | datetime | Кінець перерви |
CountJobs | int | Кількість зареєстрованих послуг |
CountJobsAllow | int | Кількість доступних реєстрацій |
ReturnInfo | об'єкт ReturnInfo | Інформація про результати виконання |
Цей запит отримує список днів, в які доступна попередня реєстрація для вказаної послуги.
GetTimeIntervals()
Expand | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
Цей запит отримує список часових інтервалів для попередньої реєстрації на вказану дату. URL |
Параметр | Тип даних | Обов'язковість | Опис |
---|---|---|---|
authToken | Guid | Токен авторизації. | |
organisationId | int | ID організації. | |
serviceCenterId | int | ID сервісного центру. | |
serviceId | int | ID послуги. | |
date | datetime | Дата попередньої реєстрації. |
Тіло запиту
Code Block |
---|
{
"authToken":"11111111-abcd-dead-beef-0123456789",
"organisationId": 2,
"serviceCenterId": 1,
"serviceId": 870,
"date": "2024-03-30"
} |
Приклад запиту з використанням curl
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetTimeIntervals \
-H "Content-Type: application/json" \
-d '{
"authToken": "11111111-abcd-dead-beef-0123456789",
"organisationId": 2,
"serviceCenterId": 1,
"serviceId": 870,
"date": "2024-03-30"
}' |
Приклад відповіді
Успішна відповідь поверне JSON об'єкт зі списком часових інтервалів та інформацією про результат виконання. Приклад структури відповіді:
Code Block |
---|
{ "TimeIntervals": [ { "StartTime": "09:00:00", "StopTime": "09:30:00", "TimeType": 1, |
...
|
...
|
...
|
...
|
...
|
...
|
...
Опис полів відповіді
|
...
|
...
|
...
|
...
|
...
title | GetTimeIntervals() |
---|
Опис запиту GetTimeIntervals()
Цей запит отримує список часових інтервалів для попередньої реєстрації на вказану дату.
URL https://{HOST}/api/servicehub/GetTimeIntervals
Метод
'POST'
Параметри запиту
Запит має включати тіло з наступними параметрами:
authToken
(Guid): Токен авторизації.organisationId
(int): Ідентифікатор організації.serviceCenterId
(int): Ідентифікатор сервісного центру.serviceId
(int): Ідентифікатор послуги.date
(datetime): Дата попередньої реєстрації.
Тіло запиту
|
Цей запит отримує список часових інтервалів для попередньої реєстрації на вказану дату.
GetDaysAndIntervals()
Expand | ||
---|---|---|
| ||
Цей запит отримує список днів з часовими інтервалами, в які доступна попередня реєстрація |
...
зазначеної послуги. URL |
Параметр | Тип даних | Обов'язковість | Опис |
---|---|---|---|
authToken | Guid | Токен авторизації. | |
organisationId | int | ID організації. | |
serviceCenterId | int | ID сервісного центру. | |
serviceId | int | ID послуги. | |
startDay | datetime | Початкова дата діапазону днів попередньої реєстрації. | |
stopDay | datetime | Кінцева дата діапазону днів попередньої реєстрації. |
Тіло запиту
Code Block |
---|
{
"authToken":"11111111-abcd-dead-beef-0123456789",
"organisationId": 2,
"serviceCenterId": 1,
"serviceId": 870,
"startDay": "2024-03-17",
"stopDay": "2024-03-18"
} |
Приклад запиту з використанням curl
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetDaysAndIntervals \
-H "Content-Type: application/json" \
-d '{
"authToken": "11111111-abcd-dead-beef-0123456789",
"organisationId": 2,
"serviceCenterId": 1,
"serviceId": 870,
"startDay": "2024-03-17",
"stopDay": "2024-03-18"
}' |
Приклад відповіді
Успішна відповідь поверне JSON об'єкт зі списком днів та часових інтервалів, а також інформацією про результат виконання. Приклад структури відповіді:
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Приклад запиту з використанням curl
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Успішна відповідь поверне JSON об'єкт зі списком часових інтервалів та інформацією про результат виконання. Приклад структури відповіді:
...
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Опис полів відповіді
|
...
Цей запит отримує список часових інтервалів для попередньої реєстрації на вказану дату.
...
Опис запиту GetDaysAndIntervals()
Цей запит отримує список днів з часовими інтервалами, в які доступна попередня реєстрація зазначеної послуги.
CustomerPush()
Expand | ||
---|---|---|
| ||
Цей запит виконує попередню реєстрацію клієнта. URL |
...
|
...
параметрами:
|
...
|
...
|
...
|
...
|
...
|
...
Тіло запиту
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Приклад запиту з використанням
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Успішна відповідь поверне JSON об'єкт |
...
з інформацією про реєстрацію та результат виконання. Приклад структури відповіді:
|
...
|
...
|
...
Опис полів відповіді
...
Опис полів відповіді
|
Цей запит
...
виконує попередню реєстрацію клієнта.
CustomerPreReg()
Expand | |
---|---|
|
...
|
...
Цей запит виконує попередню реєстрацію клієнта. URL https://{HOST}/api/servicehub/ |
...
CustomerPreRegМетод
Параметри запитуЗапит має включати тіло з наступними параметрами: |
...
|
...
Тіло запиту
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Приклад запиту з використанням
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Приклад |
...
відповідіУспішна відповідь поверне JSON об'єкт з інформацією про реєстрацію та результат виконання. Приклад структури відповіді:
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Опис полів відповіді |
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Цей запит виконує попередню реєстрацію клієнта.
BookCustomer()
Expand | |
---|---|
|
...
|
...
Цей запит виконує бронювання реєстрації, яке потребує підтвердження для завершення реєстрації. URL |
Параметр | Тип даних | Обов'язковість | Опис |
---|---|---|---|
authToken |
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
Приклад відповіді Успішна відповідь поверне JSON об'єкт з інформацією про реєстрацію та результат виконання. Приклад структури відповіді:
Опис полів відповіді
|
Цей запит виконує бронювання реєстрації, яке потребує підтвердження для завершення реєстрації.
ConfirmRegistration()
Expand | |
---|---|
|
...
|
...
Цей запит підтверджує бронювання реєстрації, яке було виконано за допомогою |
...
методу URL |
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
Успішна відповідь поверне JSON об'єкт з інформацією про результат виконання. Приклад структури відповіді:
Опис полів відповіді
|
Цей запит підтверджує бронювання реєстрації, яке було виконано за допомогою методу BookCustomer()
.
GetReceipt()
Expand | |
---|---|
|
...
|
...
Цей запит отримує HTML розмітку чека для зазначеної реєстрації. URL |
...
|
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
Успішна відповідь поверне HTML розмітку чека та інформацію про результат виконання. Приклад структури відповіді:
Опис полів відповіді
|
Цей запит отримує HTML розмітку чека для зазначеної реєстрації.
GetOrderHistory()
Expand | |
---|---|
|
...
|
...
Цей запит повертає історію дій, пов'язаних з життєвим циклом реєстрації. URL |
Параметр |
---|
...
|
...
|
...
|
...
Тіло запиту
Приклад відповіді Успішна відповідь поверне історію дій для вказаної реєстрації разом з інформацією про результат виконання. Приклад структури відповіді:
Опис полів відповіді
|
Цей запит повертає історію дій, пов'язаних з життєвим циклом реєстрації.
DropOrder()
Expand | |
---|---|
|
...
|
...
Цей запит видаляє реєстрацію за вказаним унікальним ідентифікатором. URL |
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
Приклад відповіді Успішна відповідь підтверджує видалення реєстрації. Приклад структури відповіді:
Опис полів відповіді
|
Цей запит видаляє реєстрацію за вказаним унікальним ідентифікатором.
GetActivatedOrderInfo()
Expand | |
---|---|
|
...
|
...
Цей запит повертає інформацію про активовану реєстрацію, таку як очікуваний час до виклику, кількість клієнтів на робочому місці та список активних робочих місць. URL |
...
|
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
Відповідь містить інформацію про активовану реєстрацію:
Опис полів відповіді
|
Цей запит повертає інформацію про активовану реєстрацію, таку як очікуваний час до виклику, кількість клієнтів на робочому місці та список активних робочих місць.
SetAssessment()
Expand | |
---|---|
|
...
|
...
Цей запит дозволяє встановити оцінку якості наданої послуги для конкретної реєстрації. URL |
Параметр | Тип даних | Обов'язковість | Опис |
---|---|---|---|
authToken |
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Тіло запиту
Приклад запиту з використанням
Приклад відповіді Відповідь підтверджує успішне виконання запиту:
Опис полів відповіді
|
Цей запит дозволяє встановити оцінку якості наданої послуги для конкретної реєстрації.
GetOrganisationInfo()
Expand | |
---|---|
|
...
|
...
Цей запит повертає інформацію про підрозділи організації, включаючи деталі про сервісні центри, їхнє місцезнаходження, кількість оброблених та очікуючих реєстрацій тощо. URL |
Параметр | Тип даних | Обов'язковість | Опис |
---|---|---|---|
authToken | Guid | Токен авторизації. | |
organisationId | int | ID організації. |
authToken
(Guid): Токен авторизації.organisationId
(int): Ідентифікатор організації.
Тіло запиту
Code Block |
---|
{
"authToken": "11111111-abcd-dead-beef-0123456789",
"organisationId": 1
} |
Приклад
...
запиту |
...
з |
...
використанням |
...
|
Code Block |
---|
curl -X POST https://{HOST}/api/servicehub/GetOrganisationInfo \
-H "Content-Type: application/json" \
-d '{
"authToken": "11111111-abcd-dead-beef-0123456789",
"organisationId": 1
}' |
Приклад
...
відповідіВідповідь містить деталі про сервісні центри організації:
|
...
полів |
...
відповіді
|
Цей запит повертає інформацію про підрозділи організації, включаючи деталі про сервісні центри, їхнє місцезнаходження, кількість оброблених та очікуючих реєстрацій тощо.
GetServiceCentersSettings()
Expand | |
---|---|
|
...
Объект ReturnInfo
предоставляет информацию о результате выполнения запроса. В зависимости от результата выполнения запроса, объект ReturnInfo
может содержать разные коды ошибок и сообщения.
Поля объекта ReturnInfo
- ReturnCode (int): Код ошибки.
- ReturnSubcode (int): Код ошибки сервера очереди.
- ReturnMessage (string): Сообщение о результате выполнения.
Возможные результаты выполнения запросов
Успешное выполнение
| ||||||||||||||
Метод повертає параметри сервісних центрів. Метод не призначений для використання клієнтами. URL: Метод
Параметри запиту Запит має включати тіло з наступними параметрами:
Тіло запиту
|
...
Приклад запиту з використанням
|
...
|
...
Приклад відповіді
|
...
|
...
|
...
...
Ошибка ServiceHub
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Ошибка на стороне сервера очереди
...
|
...
|
...
|
...
|
Коды ошибок ServiceHub
Код ошибки | Описание |
---|---|
1001 | Соответствующий параметр не указан, имеет недопустимое значение или неверный формат |
1002 | Не указан параметр authToken |
1003 | Не указан параметр organisationId |
1004 | Не указан параметр serviceCenterId |
1005 | Не указан параметр orderGuid |
1006 | Не указан параметр customerId |
1007 | Не указан параметр languageId |
1008 | Не указан параметр customerName |
1009 | Не указан параметр customerPhone |
1010 | Не указан параметр customerEmail |
1011 | Не указан параметр customerInfo |
1012 | Не указан параметр regTime |
1013 | Значение параметра regTime имеет неверный формат |
1014 | Переданный токен авторизации не соответствует текущему IP адресу или имени сервера клиента |
1015 | Токен авторизации не активирован |
1016 | Время доступности токена авторизации истекло |
1017 | Организация с указанным ID не найдена |
1018 | Не указан уникальный идентификатор организации |
1019 | Уникальный идентификатор организации имеет неверный формат |
1020 | Организация с указанным GUID не найдена |
1021 | IP адрес или имя сервера клиента изменились с момента последнего входа |
1022 | Ошибка подключения к БД |
1023 | Организация с указанным ID в данный момент недоступна |
1024 | Сервисный центр с указанным ID в данный момент недоступен |
1025 | Интервал между регистрациями слишком мал |
Коды ошибок сервера очереди
Код ошибки | Описание |
---|---|
2001 | Несуществующий токен авторизации |
2002 | Токен авторизации не активирован |
2003 | Время доступности токена авторизации истекло |
2004 | Переданный токен авторизации не допускает запросы с текущего IP адреса или имени сервера клиента |
2006 | Организация с указанным ID не найдена |
2017 | Не указан уникальный идентификатор организации |
2018 | Уникальный идентификатор организации имеет неверный формат |
2019 | Организация с указанным GUID не найдена |
2025 | IP адрес или имя сервера клиента изменились с момента последнего входа |
2026 | Ошибка подключения к БД |
2032 | Организация с указанным ID в данный момент недоступна |
2033 | Сервисный центр с указанным ID в данный момент недоступен |
2034 | Интервал между регистрациями слишком мал |
Ошибки сервера очереди
Опис полів відповіді
|
Метод повертає параметри сервісних центрів. Метод не призначений для використання клієнтами.
ReturnInfo
Expand | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||
Об'єкт Поля об'єкту
Можливі результати виконання запитівУспішне виконання
Помилка ServiceHub
Помилка на стороні сервера черги
Коди помилок ServiceHub
|
...
Table of Contents | ||
---|---|---|
|