You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

Схема взаємодії Клієнта з Серверами черги

Схема взаимодействия Copy
 

Загальна інформація щодо роботи із запитами

Всі запити мають бути у форматі POST. Content-type:application/json

Запити:



 GetOrganisations()

Цей запит використовується для отримання списку організацій. Він вимагає аутентифікацію за допомогою токену і підтримує багатомовність через параметр languageId.

URL
https://{HOST}/api/servicehub/GetOrganisations

Метод

'POST'

Параметри запиту

Запит має включати тіло з двома параметрами:

  • authToken (Guid): Токен аутентифікації, який підтверджує, що користувач має право доступу до API.
  • languageId (int): Ідентифікатор мови, якою користувач хоче отримати дані.

 Тіло запиту

{
    "authToken": "11111111-abcd-dead-beef-0123456789",
    "languageId": "1"
}

Приклад відповіді

 {
    "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"
    }
}

 Опис полів

ВластивістьТип данихОбов'язковістьОпис
OrganisationIdint
ID організації
OrganisationNamestring
Назва організації
OrgTypeIdint
ID типу організації
OrgTypeDescriptionstring
Назва типу організації
Codeint
Код організації
LocationIdint
ID локації
GeoInfo.CityIdint
ID міста
GeoInfo.Citystring
Назва міста
GeoInfo.RegionIdint
ID региона (области)
GeoInfo.Regionstring
ID регіону (області)
GeoInfo.CountryIdint
ID країни
GeoInfo.Countrystring
Назва країни
GeoInfo.Addressstring
Адреса організації
ReturnInfoОбъект ReturnInfo
Інформація про результати виконання

Опис запиту GetServiceCenters()

Цей запит використовується для отримання списку сервісних центрів.

URL

https://{HOST}/api/servicehub/GetServiceCenters

Метод

POST

Параметри запиту

Запит має включати тіло з трьома параметрами:

  • authToken (Guid): Токен аутентифікації, який підтверджує, що користувач має право доступу до API.
  • organisationId (int): Ідентифікатор організації.
  • languageId (int): Ідентифікатор мови, якою користувач хоче отримати дані.

Тіло Запиту 

 {
    "authToken": "11111111-abcd-dead-beef-0123456789",
    "organisationId": "2",
    "languageId": "1"
}

Приклади відповіді

 {
    "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"
    }
}

Опис полів відповіді


ВластивістьТип данихОбов'язковістьОпис
ServiceCenterIdint ID сервісного центру
ServiceCenterNamestring
Назва сервісного центру
OrganisationIdint
ID організації
RegistrationDaysLimitint
Ліміт кількості днів для попередньої реєстрації
Sopdatetime
Дата, з якої дозволена попередня реєстрація
GeoInfo.CityIdint
ID міста
GeoInfo.Citystring
Назва міста
GeoInfo.RegionIdint
ID регіону (області)
GeoInfo.Regionstring
Назва регіону (області)
GeoInfo.CountryIdint
ID країни
GeoInfo.Countrystring
Назва країни
GeoInfo.Addressstring
Адреса організації
ReturnInfoоб'єкт ReturnInfo
Інформація про результати виконання
ReturnInfo.ReturnCodeint
Код результату
ReturnInfo.ReturnSubcodeint
Підкод результату
ReturnInfo.ReturnMessagestring
Повідомлення про результат

































































                
        
    
        


                        
    





    

	

		
    
    
            
  • 
            No labels
        
    •