Currency

🔒 #26723 Конвертация суммы между RUB, USD, EUR и CNY по курсу ЦБ РФ на дату (по умолчанию - сегодня по часовому поясу компании). Курсы дня хранятся у нас; дня нет - загружается из ЦБ. На выходной и праздник - курс последнего рабочего дня.

#26723 Конвертация суммы между RUB, USD, EUR и CNY по курсу ЦБ РФ на дату (по умолчанию - сегодня по часовому поясу компании). Курсы дня хранятся у нас; дня нет - загружается из ЦБ. На выходной и праздник - курс последнего рабочего дня.

Access: authorized (10 ) · Scope: read

Allows: не требуются — shared reference data: CBR exchange rates are the same for all companies

TypeScript (copy-paste)

GET /currency/convert

<details open><summary><b>Params</b></summary>
export interface CurrencyConvertParams {
  amount: number
  from: Currency_Code
  to: Currency_Code
  date?: string | null
}
</details> <details open><summary><b>Response</b></summary>
export type CurrencyConvertResponse = IServerResponse<CurrencyService_ConvertResult>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
</details>

Полный файл типов: /docs/types · raw: /docs/api-types.ts

get/currency/convert

Request

  • Base URL: http://localhost
  • URL: http://localhost/currency/convert
  • Auth: one of:
    • API key in header sid and API key in header rts and API key in header sig
    • HTTP bearer

Query parameters

amountnumber required

Можно передать header amount (сервер мержит headers+query)

from'RUB' | 'USD' | 'EUR' | 'CNY' required

RUB = "RUB", USD = "USD", EUR = "EUR", CNY = "CNY"

Можно передать header from (сервер мержит headers+query)

to'RUB' | 'USD' | 'EUR' | 'CNY' required

RUB = "RUB", USD = "USD", EUR = "EUR", CNY = "CNY"

Можно передать header to (сервер мержит headers+query)

datestring nullable

Можно передать header date (сервер мержит headers+query)

Headers

devIDstring uuid required

UUID устройства клиента

tzstring required
Example:Europe/Moscow

Таймзона клиента (IANA или offset)

appstring required
Example:kosmodrom-web

Имя клиентского приложения

appVerstring required
Example:1.0.0

Версия клиента

rKeystring

Уникальный ключ запроса для логов/саппорта

Response

OK — IServerResponse<CurrencyService_ConvertResult>

codeinteger required
dataCurrencyServiceConvertResult required

Schema CurrencyService_ConvertResult (inferred from ResponseData AST)

srvTSinteger required

Server timestamp (ms)

rkeystring required

Request key

Example response

{
  "code": 200
}

Changes

No recorded changes to this operation across all 1 revision of this API.