API Золотых Слитков НБТ

Ежедневные цены мерных золотых слитков Национального Банка Таджикистана

📋 Обзор API

Этот API предоставляет актуальные данные о ценах на золотые слитки НБТ в формате JSON.

База URL: https://your-domain.com/gold_export.php

Формат: JSON

Метод: GET

Кодировка: UTF-8

🚀 Быстрый старт

Примеры запросов:

Все слитки (последняя дата) По дате Вес 5 грамм

🔗 Endpoints (конечные точки)

GET /gold_export.php

Описание: Получить все золотые слитки за последнюю доступную дату

GET /gold_export.php?date={DD.MM.YYYY}

Описание: Получить слитки за конкретную дату

Пример: gold_export.php?date=05.02.2026

GET /gold_export.php?weight={вес}

Описание: Получить слитки конкретного веса

Пример: gold_export.php?weight=5

GET /gold_export.php?id={id}

Описание: Получить конкретный слиток по ID

Пример: gold_export.php?id=123

⚙️ Параметры запроса

Параметр Тип Обязательный Описание Пример
date string Нет Дата в формате DD.MM.YYYY 05.02.2026
weight string Нет Вес слитка в граммах 5, 10, 20
id integer Нет Уникальный ID слитка 123
💡 Совет: Параметры можно комбинировать: gold_export.php?date=05.02.2026&weight=5

📦 Структура ответа

Успешный ответ (200 OK):

{
  "success": true,
  "date": "05.02.2026",
  "currency": "TJS",
  "total_records": 2,
  "data": [
    {
      "id": 123,
      "BarsWeight": "5",
      "RepurchasePrice": "5299.6000",
      "SellingPrice": "5499.6000",
      "Date": "05.02.2026"
    }
  ],
  "available_dates": [
    "05.02.2026",
    "04.02.2026"
  ],
  "api_info": {
    "description": "API ежедневных цен мерных золотых слитков НБТ",
    "description_en": "NBT Gold Bars Daily Price API",
    "endpoints": { ... }
  }
}

Описание полей:

Поле Тип Описание
success boolean Статус выполнения запроса
date string Дата данных
currency string Валюта цен (TJS - Таджикский сомони)
total_records integer Количество записей в ответе
data array Массив данных о золотых слитках
available_dates array Список всех доступных дат

Поля объекта слитка (data):

Поле Тип Описание
id integer Уникальный ID слитка
BarsWeight string Вес слитка в граммах
RepurchasePrice string Цена обратного выкупа в сомони
SellingPrice string Цена продажи в сомони
Date string Дата актуальности цены

💻 Примеры использования

JavaScript (fetch):

fetch('gold_export.php?date=05.02.2026')
  .then(response => response.json())
  .then(data => {
    console.log('Всего слитков:', data.total_records);
    data.data.forEach(bar => {
      console.log(`Вес: ${bar.BarsWeight}г, Цена: ${bar.SellingPrice} TJS`);
    });
  });

PHP (cURL):

$ch = curl_init('https://your-domain.com/gold_export.php?weight=5');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data['data'] as $bar) {
    echo "Цена продажи: " . $bar['SellingPrice'] . " TJS\n";
}

Python (requests):

import requests

response = requests.get('https://your-domain.com/gold_export.php')
data = response.json()

for bar in data['data']:
    print(f"Вес: {bar['BarsWeight']}г")
    print(f"Цена продажи: {bar['SellingPrice']} TJS")
    print("---")

jQuery:

$.getJSON('gold_export.php?date=05.02.2026', function(data) {
    $('#gold-list').empty();
    data.data.forEach(function(bar) {
        $('#gold-list').append(
            '<div>' + bar.BarsWeight + 'г - ' + 
            bar.SellingPrice + ' TJS</div>'
        );
    });
});

🌐 CORS

API поддерживает Cross-Origin Resource Sharing (CORS), что позволяет делать запросы с любых доменов.

Header: Access-Control-Allow-Origin: *

⚠️ Ограничения

📞 Поддержка

По вопросам работы API обращайтесь в службу поддержки НБТ.