POST /api/v1/generate
Отправьте JSON с заголовком Content-Type: application/json. Ниже параметры для генерации целых чисел.
| Параметр | Описание |
|---|---|
tool | Имя генератора. Для целых чисел укажите integers. |
input.min / input.max | Включительные границы от −10¹² до 10¹². По умолчанию 1 и 100. |
input.count | От 1 до 10 000. По умолчанию 1. |
input.unique | Передайте true для выборки без повторов. По умолчанию false. |
input.sort | Передайте true для сортировки по возрастанию. По умолчанию порядок генерации. |
locale | Необязательный параметр. С ним ответ включает formatted. en, ru, zh-TW, zh-CN, hi, ja, ko, es |
curl
curl -X POST "https://randomkit.tech/api/v1/generate" -H "Content-Type: application/json" -d '{"tool":"integers","locale":"ru","input":{"min":1,"max":100,"count":5,"unique":true,"sort":true}}'fetch
const response = await fetch('/api/v1/generate', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({"tool":"integers","locale":"ru","input":{"min":1,"max":100,"count":5,"unique":true,"sort":true}})
})
const data = await response.json()
if (!response.ok) throw new Error(data.error)
console.log(data.values, data.formatted)
console.log(response.headers.get('RateLimit-Remaining'))Ответ и остаток квоты
Успешный ответ содержит tool и values. При указании locale добавляются locale, label и formatted. У форматированного целого числа есть поля number и text.
RateLimit-Limit— дневной лимитRateLimit-Remaining— остаток запросов после вызоваRateLimit-Reset— время сброса в секундах Unix
400 — некорректный запрос. 429 — квота исчерпана, Retry-After указывает число секунд до повтора. 503 — сервис квот недоступен. Запросы с ответом 400 тоже расходуют квоту.
Проверяемые розыгрыши и Seed
Режимы Seed и drand доступны в браузерных инструментах. На странице розыгрыша можно выбрать победителя и скачать JSON-доказательство. Открыть проверяемый розыгрыш