> ## Documentation Index
> Fetch the complete documentation index at: https://wallet-docs.iexexchanger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Инструменты: Postman и SDK

> Готовая Postman-коллекция с HMAC-подписью и SDK для TypeScript, PHP и Python

## Postman-коллекция

Скачайте [iexwallet-public-api.postman\_collection.json](/iexwallet-public-api.postman_collection.json) и
импортируйте в Postman (File → Import). Коллекция генерируется из актуального OpenAPI
(`npm run openapi:postman` в репозитории платформы), запросы сгруппированы по разделам.

<Steps>
  <Step title="Переменные коллекции">
    `baseUrl` — адрес вашего инстанса, `apiId` — API id ключа, `apiSecret` — его секрет (тип *secret*,
    хранится только в вашем Postman).
  </Step>

  <Step title="Подпись">
    Pre-request скрипт коллекции сам добавляет `X-Api-Id`, `X-Timestamp` и `X-Signature`
    (`HMAC-SHA256(timestamp + "." + raw_body, apiSecret)`) — ничего вручную считать не нужно.
  </Step>

  <Step title="Песочница">
    Для сайта в [режиме песочницы](/sandbox) в папке *public · sandbox* есть запросы эмуляции платежа и исхода выплаты.
  </Step>
</Steps>

<Note>
  Тело запроса подписывается **после** подстановки переменных Postman — используйте `{{...}}` в JSON свободно.
</Note>

## SDK

SDK генерируются из того же OpenAPI (`openapi-generator`) и лежат в репозитории платформы в `sdks/`:

| Язык       | Пакет             | Установка                                                                                              |
| ---------- | ----------------- | ------------------------------------------------------------------------------------------------------ |
| TypeScript | `sdks/typescript` | `npm install <путь или tarball>` — ESM/CJS, типы включены                                              |
| PHP        | `sdks/php`        | `composer require` из локального репозитория (`repositories: [{ "type": "path", "url": "sdks/php" }]`) |
| Python     | `sdks/python`     | `pip install sdks/python`                                                                              |

Подпись HMAC в SDK не встроена (OpenAPI описывает только заголовки) — используйте примеры из
[Аутентификации](/authentication) и `docs/integrators/code-samples` для готовых функций подписи на каждом языке.
Пересборка: `npm run sdk:gen` (нужен Docker); CI пересобирает SDK при изменении спецификации и кладёт их
в ветку `bot/sdk-regenerate`.

## OpenAPI

Полная спецификация Public API: [openapi-public.json](/openapi-public.json) — подходит для генерации
клиентов любым инструментом (openapi-generator, orval, Kiota).