---
title: "SDK для TypeScript"
description: "Посібники та документація ресурсів TypeScript SDK Requiply."
canonical_url: "https://requiply.com/docs/uk/developers/typescript-sdk"
---
# SDK для TypeScript

> Посібники та документація ресурсів TypeScript SDK Requiply.

Пакет `@requiply/api-sdk` експортує `RequiplyClient`, `RequiplyError`, а також усі публічні типи TypeScript зі своєї кореневої точки входу.

## Початок роботи

- [Встановлення](https://requiply.com/docs/uk/developers/typescript-sdk/installation)
- [Швидкий старт](https://requiply.com/docs/uk/developers/typescript-sdk/quick-start)
- [Використання в браузері та на сервері](https://requiply.com/docs/uk/developers/typescript-sdk/browser-and-server-usage)
- [Обробка помилок](https://requiply.com/docs/uk/developers/typescript-sdk/error-handling)
- [Параметри запитів](https://requiply.com/docs/uk/developers/typescript-sdk/request-options)

## Ресурси

- [Інвентар і категорії](https://requiply.com/docs/uk/developers/typescript-sdk/inventory-and-categories), зокрема комплекти
- [Доступність і ціни](https://requiply.com/docs/uk/developers/typescript-sdk/availability-and-pricing)
- [Бронювання](https://requiply.com/docs/uk/developers/typescript-sdk/bookings)
- [Клієнти](https://requiply.com/docs/uk/developers/typescript-sdk/clients)
- [Продажі та товари на продаж](https://requiply.com/docs/uk/developers/typescript-sdk/sales)
- [Організація](https://requiply.com/docs/uk/developers/typescript-sdk/organization)
- [Звіти](https://requiply.com/docs/uk/developers/typescript-sdk/reports)

Усі запити надсилаються за адресою:

```text
https://api.requiply.com/api/public/v1
```

## Оновлення зі старіших версій

Версія 0.2.0 узгоджує SDK з публічним API. Ці зміни можуть зламати код, написаний для 0.1.x:

<table>
<thead>
  <tr>
    <th>
      Зміна
    </th>
    
    <th>
      Що робити
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        RequiplyError.code
      </code>
      
       прибрано. Його ніколи не заповнювали.
    </td>
    
    <td>
      Читайте <code>
        error.reason
      </code>
      
      , щоб отримати машиночитну причину, а <code>
        error.data
      </code>
      
      , щоб отримати повʼязані з нею поля. Див. <a href="https://requiply.com/docs/uk/developers/typescript-sdk/error-handling">
        Обробка помилок
      </a>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      Параметр запиту <code>
        idempotencyKey
      </code>
      
       прибрано. API ніколи не усував дублікати запитів.
    </td>
    
    <td>
      Не повторюйте <code>
        bookings.create()
      </code>
      
       чи <code>
        sales.create()
      </code>
      
       наосліп: повтор може створити друге бронювання чи продаж. Див. <a href="https://requiply.com/docs/uk/developers/typescript-sdk/request-options#%D0%BF%D0%BE%D0%B2%D1%82%D0%BE%D1%80%D0%BD%D1%96-%D1%81%D0%BF%D1%80%D0%BE%D0%B1%D0%B8">
        Параметри запитів
      </a>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        bookings.create()
      </code>
      
       повертає або створене бронювання, або відхилене.
    </td>
    
    <td>
      Перевіряйте <code>
        result.success
      </code>
      
      , перш ніж читати <code>
        reservationId
      </code>
      
      . Див. <a href="https://requiply.com/docs/uk/developers/typescript-sdk/bookings#%D0%BE%D0%B1%D1%80%D0%BE%D0%B1%D0%BA%D0%B0-%D0%B2%D1%96%D0%B4%D0%BF%D0%BE%D0%B2%D1%96%D0%B4%D1%96">
        Бронювання
      </a>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        paymentType
      </code>
      
       обовʼязковий, якщо <code>
        asRequest
      </code>
      
       не дорівнює <code>
        true
      </code>
      
      .
    </td>
    
    <td>
      Передавайте <code>
        paymentType
      </code>
      
       для звичайних бронювань. API і раніше відхиляв їх без нього.
    </td>
  </tr>
</tbody>
</table>

Версія 0.2.0 також додає: ресурси [Продажі](https://requiply.com/docs/uk/developers/typescript-sdk/sales); `saleLines` і `adjustment` у розрахунках ціни та бронюваннях; `workingHours` в `org.info()`; `saleItems` у деталях бронювання; `excludeFromDiscounts` у послугах; `stillOutUnits` у записах звіту про прострочення. Повний перелік наведено в [CHANGELOG](https://github.com/Requiply/RequiplyNPM/blob/main/packages/api-sdk/CHANGELOG.md) пакета.

Версія 0.2.1 додає [комплекти](https://requiply.com/docs/uk/developers/typescript-sdk/inventory-and-categories#bundleslist): `bundles.list()` і `bundles.get()`; `bundles` у `pricing.quote()` і `bookings.create()`; `bundleDiscountAmount` і `lineBundles` у розрахунках ціни; `bundles` у деталях групи товарів. Нічого не ламається.


## Sitemap

See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.