# Загальний опис

Ласкаво просимо до документації Прозора Мережа веб-API.

Процесинговий центр DCM – це платформа, на якій працює Прозора Мережа (TPN -Transparent Network).

Тут партнери можуть знайти всю необхідну інформацію щодо вимог і функцій нашого веб-API, а також його налаштування для оптимального використання.

Функціональність платформи дозволяє створювати облікові записи, налаштовувати ролі, реєструвати транзакції та створювати цифрові ідентифікатори для різних сутностей.

Прозора Мережа в якості послуг надає обробку повідомлень з інтеграцією в загальнодоступній мережі децентралізованих цифрових ідентифікаторів Stellar.

Процесинговий центр DCM є технічним провайдером Прозорої Мережі для комунікації між Контрагентами.

Прозора Мережа надає можливість використовувати публічний інтерфейс для перегляду транзакцій Stellar.Expert, який можна використовувати як альтернативне джерело інформації, якщо потрібні контрольні звірки.<br>

<figure><img src="https://content.gitbook.com/content/HZwqr89UMdd8lMpRZQIi/blobs/4DxrYMZH95XVnNGxSOWy/Main%20(Gide%20for%20Bank)_20231227-Copy%20of%20simple.jpg" alt=""><figcaption></figcaption></figure>

Принцип генерації та перевірки токенів авторизації.

Процес обміну даними використовує принципи REST API (запити GET, POST, PUT, DEL).&#x20;

Авторизація здійснюється за допомогою токенів, згенерованих Банком, в запитах за допомогою методів платформи DCM. Токен авторизації підлягає перевірці — отримавши запит з токеном, DCM ініціює перевірку валідації цього токену шляхом зворотного запиту до Банку — до попередньо узгодженої комунікації. Технічні вимоги до токенів формуються та узгоджуються сторонами в процесі реалізації проекту. Банк встановлює термін дії токена X-auth.&#x20;

Рекомендується обмежити термін дії токена до 1200 секунд.&#x20;

Поки процес перевірки токену не буде завершено, вихідний запит із певним токеном не виконується, а очікує завершення перевірки.&#x20;

У разі невдалої перевірки токену - оригінальний запит відхиляється як невдалий.&#x20;

У разі успішної перевірки токена - виконується запит і надається синхронна відповідь про реєстрацію транзакції (факт реєстрації транзакції ≠ статусу фінансової транзакції).

## Управління ключами та принцип підписання запитів

Обмін інформацією між Процесинговим Центром DCM та Банком відбувається за принципом підпису та перевірки підпису. Для цього Банк генерує пару транспортних ключів (публічний та приватний). Рекомендовано використовувати алгоритм RSA з ключем щонайменше 2048 біт.&#x20;

Після генерації ключів публічний ключ передається на обробку до DCM, а приватний ключ залишається на стороні банку. Передача публічного ключа здійснюється відповідно до індивідуальних регуляторних вимог Банку-учасника.&#x20;

Банк генерує підпис за допомогою приватного ключа під час ініціювання запитів через API для обробки Процесинговим Центром. DCM використовує публічний ключ для перевірки автентичності підпису.&#x20;

Якщо підпис і токен авторизації дійсні, то запит можна обробляти, інакше запит позначається як недійсний.

У  [glosarii](https://docs.prozora.network/aid-support/general/zagalnii-opis/glosarii "mention") ви можете переглянути загальні терміни, які використовуються в цьому посібнику.

Рекомендується починати ознайомлення зі сторінки [plan-integraciyi](https://docs.prozora.network/aid-support/general/plan-integraciyi "mention").

Щоб працювати з DCM API, необхідно увійти в систему, як описано в розділі[avtorizaciini-zapiti](https://docs.prozora.network/aid-support/api-metodi/avtorizaciini-zapiti "mention").


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.prozora.network/aid-support/general/zagalnii-opis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
