VES: Cargando
EURO: Cargando
CNY: Cargando
RUB: Cargando
USD: Cargando
LTC: Cargando
DASH: Cargando

< Разработчики >

Здесь вы найдёте файлы, документы и указания, необходимые для осуществления разработок, касающихся Petro
Пример 1

Различные криптовалюты
- к фиатным валютам

Пример 2

Различные криптовалюты
- к Petro

ВВЕДЕНИЕ
API PRICE

Это API для консультаций различных цен при обмене криптовалют на фиатные валюты и наиболее признанных криптовалют на Petro (PTR). Данный API возвращает информацию о цене нужной криптовалюты или фиатной валюты на основании её кода в формате JSON. Он будет ежедневно (в 7 утра по венесуэльскому времени) обновлять цены на фиатные валюты.

Стоимость Petro может быть рассчитана в 35 фиатных валютах (согласно котировкам Центрального банка Венесуэлы BCV, прилагается таблица имеющихся валют) и трёх криптовалютах (биткойн, лайткойн, DASH).

Даный API абсолютно бесплатный.

  • Мы не можем гарантировать абсолютную точность указанных обменных курсов.
  • Вы должны всегда подтверждать обменные курсы, прежде чем совершать какие-либо транзакции, на которые могут повлиять изменения курсов.
  • Курсы криптовалют основаны на данных обменного курса, предоставляемых API.
  • Все курсы показаны только в ознакомительных целях и могут быть изменены без предварительного уведомления.
  • Поскольку обменные курсы для реальных транзакций могут различаться, мы не предлагаем заключать какие-либо транзакции с любым из указанных курсов.
  • Указанные курсы являются составными и не предназначены для использования в инвестиционных целях.
  • Sunacrip обязуется обеспечить полную работоспособность API 24 часа в сутки, семь дней в неделю, если только возникшие обстоятельства, не зависящие от его контроля, не повлияют на предоставление данной услуги.

ПАРАМЕТРЫ

риложение API PRICE позволяет выяснять различные цены криптовалют в фиатных деньгах и самых признанных криптовалют в Petro(PTR); ниже, см. его описание:

URL:https://petroapp-price.petro.gob.ve/price/
Metodo:Post
Headers:Content-Type: application/json
Claves:coins[“acronimo”,.....] y fiats[“acronimo”,.....]
Body:
{
coins: [
  "BTC",
  "DASH",
  "LTC",
  "ETH"
 ],
fiats: [
  "USD",
  "ARS",
  "BRL",
  "BOB",
  "CAD",
  "COP",
  "CLP",
  "MXP",
  "NIO",
  "PEN",
  "DOP",
  "TTD",
  "UYU",
  "ANG",
  "CZK",
  "DKK"
 ]
}



Вызовы API могут использовать несколько параметров. Например, если вы запрашиваете цену на несколько валют, вы можете отправить вызов API для каждой из них. Вместо отдельных вызовов API для каждой валюты, можно пользоваться разделителем параметров - запятой (,).

Пример 1: Различные криптовалюты – в фиатную валюту

Операция позволяет узнать цену различных криптовалют, включая Petro, в имеющихся фиатных валютах.

URL: https://petroapp-price.petro.gob.ve/price/

Request (операция запроса):

curl -X POST \
https://petroapp-price.petro.gob.ve/price/ \
-H 'Content-Type: application/json' \
-H 'Host: api-price.petro.dom' \
-d ' {
  coins: [
   "BTC",
   "DASH",
   "LTC",
   "ETH",
   "PTR"
  ],
  fiats: [
   "USD",
   "ARS",
   "BRL",
   "BOB",
   "CAD",
   "COP",
   "CLP",
   "MXP",
   "NIO",
   "PEN",
   "DOP",
   "TTD",
   "UYU",
   "ANG",
   "CZK",
   "DKK"
  ]
 } '



imagen-1

Response (ответ):

Все типы ответа выдаются в формате application / json, следующим образом:

{
  status: 200,
  success: true,
  data: {
   BTC: {
    USD: 11571.1,
    ARS: 543197.02,
    BRL: 45905,
    BOB: 5832216.46,
    CAD: 15277.2,
    COP: 36523374.46,
    CLP: 8248083.07,
    NIO: 5095515.44,
    PEN: 38671.93,
    DOP: 611119.48,
    TTD: 95909.15,
    UYU: 408957.37,
    CZK: 270581,
    DKK: 76674.84
   },
   DASH: {
    USD: 104.25,
    ARS: 4906.14,
    BRL: 412.09,
    BOB: 52332.97,
    CAD: 137.14,
    COP: 327870.33,
    CLP: 74010.74,
    NIO: 45722.49,
    PEN: 347.16,
    DOP: 5486.02,
    TTD: 860.98,
    UYU: 3671.21,
    CZK: 2429.01,
    DKK: 688.31
   },
   LTC: {
    USD: 89.08,
    ARS: 4209.87,
    BRL: 354.98,
    BOB: 44917.85,
    CAD: 117.68,
    COP: 281339.55,
    CLP: 63524.08,
    NIO: 39244.02,
    PEN: 297.89,
    DOP: 4707.45,
    TTD: 738.79,
    UYU: 3150.2,
    CZK: 2084.29,
    DKK: 590.63
   },
   ETH: {
    USD: 217.33,
    ARS: 10263.71,
    BRL: 862.1,
    BOB: 1567.65,
    CAD: 286.91,
    COP: 685908.97,
    CLP: 154248.97,
    NIO: 95693.78,
    PEN: 726.26,
    DOP: 11476.82,
    TTD: 1801.17,
    UYU: 7680.22,
    CZK: 5081.51,
    DKK: 1439.95
   },
   PTR: {
    USD: 59.73,
    DKK: 394.28,
    CZK: 1343.75,
    ANG: 111.86,
    UYU: 2101.2,
    TTD: 402.25,
    DOP: 3028.73,
    PEN: 196.31,
    NIO: 1978.9,
    MXP: 1139.56,
    CLP: 40538.75,
    COP: 191690.38,
    CAD: 78.41,
    BOB: 409.21,
    BRL: 228.18,
    ARS: 2519.08
   }
  },
  message: "Creado"
}



*Если запрос цен будет производиться для нескольких криптовалют, то результаты будут выводиться в виде матрицы.

imagen-2

Примечание: Для строки фиатных валют длина передаваемых параметров ограничена максимумом в 100 символов; в противном случае, будет выведено следующее сообщение об ошибке:

{
  status: 200,
  success: true,
  data: {
   Response: "Error",
   Message: "tsyms param is invalid. (tsyms length is higher than maxlength: 100)",
   HasWarning: false,
   Type: 2,
   RateLimit: {},
   Data: {},
   ParamWithError: "tsyms",
   PTR: {}
  },
  message: "Creado"
}



*сообщаемая цена запрашиваемой криптовалюты будет выражена во всех запрашиваемых и имеющихся в системе фиатных валютах.

Пример 2: Другие криптовалюты – в PTR

Операция позволяет узнать цену криптовалют (BTC, DASH, LTC, ETH) в Petro (PTR), с указанием значений цены криптовалюты в Petro и Petro в криптовалюте.

URL: https://petroapp-price.petro.gob.ve/price/PTR

Request:

curl -X POST \
https://petroapp-price.petro.gob.ve/price/PTR \
-H 'Content-Type: application/json' \
-d ' {
"coins":[
  "BTC",
  "DASH",
  "LTC",
  "ETH"
 ]
}'



imagen-3

Response:{
  status: 200,
  success: true,
  data: {
   BTC: {
    BTC: 197.98428923,
    PTR: 0.00505091
   },
   LTC: {
    LTC: 1.43725156,
    PTR: 0.69577242
   },
   DASH: {
    DASH: 1.7427598,
    PTR: 0.57380254
   },
   ETH: {
    ETH: 3.55385198,
    PTR: 0.28138482
   }
  }
}



*сообщаемая цена запрашиваемой криптовалюты выражается в Petro (PTR).

imagen-4

SСОКРАЩЕНИЯ

Фиатные валюты, имеющиеся в системе

Код ISO Валюта Страна
Bs Боливар Венесуэла
USD Доллар США Соединенные Штаты
ARS Аргентинское песо Аргентина
BRL Бразильский реал Бразилия
BOB Боливиано Боливия
CAD Канадский доллар Канада
COP Колумбийское песо Колумбия
CLP Чилийское песо Чили
MXP Мексиканское песо Мексика
NIO Никарагуанская кордоба Никарагуа
PEN Соль Перу
DOP Доминиканское песо Доминиканская республика
TTD Тринидадский доллар Тринидад и Тобаго
UYU Уругвайское песо Уругвай
ANG Нидерландский антильский гульден Кюрасао
CZK Чешская крона Чехия
DKK Датская крона Дания
NOK Норвежская крона Норвегия
GBP Британский фунт Великобритания
SEK Шведская крона Швеция
CHF Швейцарский франк Швейцария
RUB оссийский рубль Россия
KRW Южнокорейский вон Южная Корея
CNY Китайский юань Китай
TWD Тайваньский новый Тайвань
INR Индийская рупия Индия
ILS Новый шекель Израиль
JPY Иена Япония
HKD Гонконгский доллар Гонконг
CNH Китайский оффшорный юань Гонконг
JOD Иорданский динар Иордания
AUD Австралийский доллар Австралия
CUC Кубинское конвертируемое песо Куба
DEG Специальные права заимствования. МВФ
EUR ЕВРО (EUR) Еврозона
TRY Турецкая лира Турция

Имеющиеся в системе криптовалюты.

Код КРИПТОВАЛЮТА
PTR Petro
BTC Биткойн
DASH Dash
LTC Лайткойн
ETH Эфир

Положения и условия

1.- О приложении

1.1.- API Petro Price - приложение для общественного пользования и бесплатной загрузки, доступное для любого пользователя, осуществившего его загрузку.

1.2.- API Petro Price позволяет наглядно представить эквивалентную стоимость Petro в 32 валютах и в трёх криптовалютах: Биткойн (BTC), Лайткойн (LTC) и Dash.

2.- Пользователи

2.1.- Любое физическое или юридическое лицо, частное или государственное может стать пользователем и скачать API Petro Price.

2.2.- Со стороны пользователей не требуется никакого вида регистрации для использования приложения API Petro Price. Поэтому от пользователей, при регистрации и использовании этого приложения, ни при каких обстоятельствах не запрашиваются персональные данные или личная информация.

3.- Услуга бесплатна

3.1.- Скачивание и использование API Petro Price полностью бесплатно.

3.2.- Услуга, предоставляемая посредством использования API Petro Price, не влечет за собой расходов для пользователей.

4.- Доступность услуги

4.1.- Услуга, предоставляемая API Petro Price, будет доступна 24 часа в сутки семь дней в неделю.

4.2.- У приложения API Petro Price и услуги, им предоставляемой, могут возникнуть проблемы, связанные с соединением и доступом к сети, но это не будет означать проблем с функционированием внутренних процессов приложения и предоставляемой услуги.

4.3.- Пользователь должен понимать и соглашаться с тем, что сценарии ошибок соединения являются внешними по отношению к работе и процессам встроенного сервиса, на котором основано использование API Petro Price.

4.4.- В любом случае, API Petro Price будет поддерживать статус постоянного обновления курсов и стоимости различных валют и криптовалют для получения результатов рассчёта эквивалентной стоимости между Petro и 32 имеющимися в системе валютами и между Petro и тремя криптовалютами, определенными в подпункте 1.2.

5.- Обновление курсов и стоимости

5.1.- Для установления эквивалентной стоимости между Petro и 32 имеющимися в системе валютами, API Petro Price берет за основу официальные курсы валют, опубликованные Центральным банком Венесуэлы и Национальным Управлением Криптоактивами и связанной с ними деятельностью (Sunacrip).

5.2.- Для установления эквивалентной стоимости между Petro и BTC, LTC или Dash, API Petro Price берёт за основу официальный курс валют, опубликованный Sunacrip из источника, который оно сочтёт заслуживающим доверия.

5.3.- Курсы валют будут обновляться ежедневно в семь часов утра по местному времени Боливарианской Республики Венесуэла.

5.4.- Курсы и стоимость BTC, LTC и Dash будут обновляться в режиме реального времени.

6.- Точность и независимость расчётов

6.1.- Пользователь API Petro Price должен понимать и соглашаться с тем, что полученные в процессе расчёта и преобразования в эквивалентные значения Petro различных валют и криптовалют результаты являются точными и зависящими от стоимости и курсов, указанных в подпунктах 5.1 и 5.2.

6.2.- Пользователь должен понимать, что курсы и справочные значения, являющиеся результатом использования API Petro Price, являются точными согласно взятым за основу значениям, тем не менее, они являются справочными и никоим образом не могут быть приняты в качестве единственно точных и имеющих всеобщее признание эквивалентных значений, установленных между Petro и 32 имеющимися в системе валютами или между Petro и тремя имеющимися в системе криптовалютами.

6.3.- Пользователи API Petro Price соглашаются с тем, что стоимость и эквивалентные значения, полученные как результат использования приложения, представляют собой справочные значения, зависящие от официальных курсов валют и обновляемые в режиме реального времени.

6.4.- Пользователи соглашаются с тем, что результаты, сообщаемые API Petro Price, не представляют собой официальный курс для обмена и оценки эквивалентной стоимости между различными валютами и криптовалютами.

6.5.- Пользователь соглашается с тем, что он является ответственным за любые сделки, осуществляемые им с любым другим лицом, физическим или юридическим, государственным или частным, с применением справочной стоимости полученных с использованием API Petro Price эквивалентных значений.

6.6.- Пользователь соглашается с тем, что любые убытки или прибыль, приобретенная в рамках сделок, упомянутых в предыдущем подпункте, являются целиком и полностью его ответственностью.

7.- Заключительные положения

7.1.- API Petro Price не несет ответственности за ошибки, которые могут совершить пользователи в момент ввода информации, связанной с валютой или криптовалютой, за эквивалентным обменом которой он обратится через приложение.

7.2.- API Petro Price - это зарегистрированная интеллектуальная собственность, поэтому любое её использование или копирование без соответствующего разрешения создателей и разработчиков будет означать нарушение международных и венесуэльских норм и договоров, касающихся защиты интеллектуальной собственности.

7.3.- Непредусмотренное в настоящем документе регулируется действующими юридическими нормами и международными или венесуэльскими соглашениями, регулирующими использование и веб-приложений и различные действия с ними.