API نرخ همکاران همتا گیفت

<?php
// Server side only: never send the API key to the browser.
$apiKey = getenv('HAMTA_API_KEY'); // hamta_live_...

$ch = curl_init('https://hamtagift.com/api/partner/v1/rates');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey, 'Accept: application/json'],
    CURLOPT_TIMEOUT        => 10,
]);
$body   = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$error  = curl_error($ch);
curl_close($ch);

if ($body === false) {
    throw new RuntimeException('Hamta API unreachable: ' . $error);
}
$data = json_decode($body, true); // null for the plain-text 403/429 of the security layer
if ($status !== 200 || !is_array($data) || empty($data['ok'])) {
    // 401: check the key. 429: wait for Retry-After. 503: keep your last good prices.
    throw new RuntimeException('Hamta API error: ' . ($data['error'] ?? ('HTTP ' . $status)));
}

foreach ($data['rates'] as $rate) {
    // Prices are decimal strings or null (= not configured). Keep them as strings
    // (e.g. bcmath) rather than float for money.
    $sellToCustomer = $rate['customerPrice']['retail']['buy'];
    echo $rate['code'], ': ', $sellToCustomer ?? 'not configured', PHP_EOL;
}

import os
from decimal import Decimal

import requests

API_KEY = os.environ["HAMTA_API_KEY"]  # hamta_live_...

resp = requests.get(
    "https://hamtagift.com/api/partner/v1/rates",
    headers={"Authorization": f"Bearer {API_KEY}", "Accept": "application/json"},
    timeout=10,
)
try:
    data = resp.json()
except ValueError:  # plain-text 403/429 from the security layer
    data = None
if resp.status_code != 200 or not data or not data.get("ok"):
    # 401: check the key. 429: wait for Retry-After. 503: keep your last good prices.
    raise RuntimeError(f"Hamta API error: {(data or {}).get('error', resp.status_code)}")

for rate in data["rates"]:
    price = rate["customerPrice"]["retail"]["buy"]  # decimal string or None
    print(rate["code"], Decimal(price) if price is not None else "not configured")

// Node.js 18+, ES module (.mjs). Server side only.
const API_KEY = process.env.HAMTA_API_KEY; // hamta_live_...

const res = await fetch("https://hamtagift.com/api/partner/v1/rates", {
  headers: { Authorization: `Bearer ${API_KEY}`, Accept: "application/json" },
  signal: AbortSignal.timeout(10_000),
});
const data = await res.json().catch(() => null); // null for the plain-text 403/429
if (!res.ok || !data?.ok) {
  // 401: check the key. 429: wait for Retry-After. 503: keep your last good prices.
  throw new Error(`Hamta API error: ${data?.error ?? `HTTP ${res.status}`}`);
}

for (const rate of data.rates) {
  // Decimal strings or null; parse with a decimal library, not Number, for money.
  console.log(rate.code, rate.customerPrice.retail.buy ?? "not configured");
}

# HAMTA_API_KEY holds your key (hamta_live_...)
curl -sS "https://hamtagift.com/api/partner/v1/rates" \
  -H "Authorization: Bearer $HAMTA_API_KEY" \
  -H "Accept: application/json"