Sandbox і live

Sandbox і live — це те саме API на тому самому хості, https://api.leeri.ai. Середовище визначає ключ, який ви надсилаєте: ключі ak_sandbox_… працюють у sandbox, ключі ak_live_… — у live. Щоб перейти в продакшен, змініть ключ, і більше нічого.

Чим вони відрізняються

	Ключ sandbox	Ключ live
Рушій	Справжній рушій скринінгу, що працює на даних вашого облікового запису	Той самий
Сторонні джерела даних	Відповіді лише зі збережених; свіжий запит ніколи не робиться	Свіжі запити, коли потрібно
Ліміт і баланс	Ніколи не витрачаються	Витрачаються, див. Обмеження частоти запитів і ліміти
Поріг частоти запитів	10 запитів за хвилину на маршрут	60 запитів за хвилину на маршрут
Перевірка транзакції без address	Не дозволена: ADDRESS_REQUIRED	Дозволена для активів, що можуть її визначити, див. Підтримувані активи

Оскільки sandbox ніколи не робить свіжого запиту, адреса без збереженої відповіді стороннього джерела перевіряється без неї. Тоді вердикт говорить про це: він може бути частковим, а причина вказана в partial_reasons. Ключ live шукає відповідь.

Середовища розділені

• check_id, ідентифікатор пакета чи вердикту, створений в одному середовищі, у другому відповідає 404 NOT_FOUND, точно як ідентифікатор, що не існує.
• Кінцеві точки вебхуків належать одному середовищу й отримують лише його події. Кожне середовище може мати до 20 активних кінцевих точок; 21-ша відповідає 400. Кожна доставка вказує, з якого середовища вона надійшла, у полі environment.
• Доказові звіти містять середовище вердикту, для якого їх видано.

Тестова адреса

Щоб перевірити шлях pending, не чекаючи справжнього повільного запиту, надішліть цю адресу ключем sandbox:

Поле	Значення
asset	BTC
address	1PENDNGCHECKADDRESSFRSANDBXTEST99

Як перевірка адреси вона завжди відповідає status: "pending" із check_id, тож ви можете з першого дня будувати й тестувати опитування та обробку вебхуків. Та сама адреса під ключем live завершується нормально; перемикач ніколи не спрацьовує поза sandbox.

curl

curl -s -X POST https://api.leeri.ai/v1/checks \
  -H "Authorization: Bearer $LEERI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject":"address","asset":"BTC","address":"1PENDNGCHECKADDRESSFRSANDBXTEST99"}'

Node.js

const response = await fetch('https://api.leeri.ai/v1/checks', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.LEERI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ subject: 'address', asset: 'BTC', address: '1PENDNGCHECKADDRESSFRSANDBXTEST99' }),
});
const { data } = await response.json();
console.log(data.status, data.check_id); // "pending" та ідентифікатор для опитування

Python

import os
import requests

response = requests.post(
    "https://api.leeri.ai/v1/checks",
    headers={"Authorization": f"Bearer {os.environ['LEERI_API_KEY']}"},
    json={"subject": "address", "asset": "BTC", "address": "1PENDNGCHECKADDRESSFRSANDBXTEST99"},
    timeout=30,
)
data = response.json()["data"]
print(data["status"], data["check_id"])  # "pending" та ідентифікатор для опитування

Далі опитуйте GET /v1/checks/{check_id}, доки status не вийде зі стану pending. Помилки та ліміти описано на сторінці Помилки.