📦 JsonBox API

Простое хранение JSON-данных в облаке

Начать использовать

О сервисе

JsonBox API — современный российский облачный сервис для хранения и обмена данными через простой REST API. Идеально подходит для разработчиков, которым нужно быстро сохранять и получать данные без настройки собственной базы данных.

Молниеносно быстро

Высокая скорость ответа API благодаря оптимизированной архитектуре и кешированию данных.

🔒

Безопасно

Индивидуальные API-ключи, шифрование данных и защита от несанкционированного доступа.

🚀

Просто

RESTful API с интуитивно понятными методами. Начните работу за 5 минут без сложной настройки.

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

Начните за 3 простых шага:

1

Регистрация

Отправьте POST запрос с вашим email для получения API-ключа

2

Сохранение

Используйте полученный API-ключ для сохранения ваших данных

3

Использование

Получайте, обновляйте и управляйте данными через простой API

Документация API

Все методы используют JSON для обмена данными и стандартные HTTP коды ответов.

Основные методы

POST /api.php?action=register
Регистрация пользователя. Получите API-ключ для доступа к сервису.
Параметры: {"email": "your@email.com"}
Вы получите два ключа: полный ключ "api_key" и read only ключ "api_key_read_only".
POST /api.php?action=regenerate_key
Перегенерация API ключа. Безопасная смена ключа при компрометации.
Параметры: {"api_key": "your_key"}
Вы получите два новых ключа: полный ключ "api_key" и read only ключ "api_key_read_only".
POST /api.php?action=store
Сохранение данных. Сохраните любые JSON-данные в вашем хранилище.
Параметры: {"api_key": "your_key", "data": {...}}
POST /api.php?action=store
Изменение данных. Измените любые JSON-данные в вашем хранилище, изпользуя data_update вместо data.
Параметры: {"api_key": "your_key", "data_update": {...}}
GET /api.php?action=get&api_key=YOUR_KEY
Получение данных. Извлеките сохранённые данные из хранилища.
DELETE /api.php?action=delete
Удаление данных. Полностью удалите данные из хранилища.
Параметры: {"api_key": "your_key"}
GET /api.php?action=stats&api_key=YOUR_KEY
Статистика. Получите информацию об использовании вашего аккаунта.
GET /api.php?action=get_ip&api_key=YOUR_KEY
Запрос IP адреса. Получите свой IP адрес без сохранения или получения данных.
GET /api.php?action=get_settings&api_key=YOUR_KEY
Получение настроек. Получите настройки, установленные ранее или дефолтные значения.
POST /api.php?action=set_setting
Установка настроек. Измените настройки, полученные с помощью get_settings.
Параметры: {"api_key": "your_key", "setting_name": "web_display_enabled", "setting_value": "true"}
Настройки устанавливают по одной: один запрос - одна настройка".

JsonBox Pages

JsonBox Pages позволяют отображать данные в виде веб-страниц напрямую из JsonBox.
Для просмотра используется read only ключ (api_key_read_only), начинающийся с "ro_".
В целях безопасности, полный ключ не сработает.
Для сохранения используется обычный метод store, обычный полный ключ АПИ "api_key" и параметры "data" или "data_update".

Минимальный набор данных

pages - набор страниц, каждая из которых которых содержит:
id - произвольный идентификатор (латиницей, без пробелов), по которому происходит обращение к странице в GET-параметре "page".
И внутри блока id:
      title - заголовок и title страницы
      items - набор информационных блоков, отображающихся в виде последовательных карточек
Для того, чтобы страница отображалась, необходимо установить настройку "web_display_enabled" в "true".
Это же значение ("true") используется по-умолчанию.

Так же можно задать в настройках тему отображения - светлую или темную.
Настройка "web_theme_style", значение light/dark, по умолчанию "light"
POST /api.php?action=store
Изменение данных.
Параметры: {"api_key": "your_key", "data": {...}}

Пример URL:

https://jsonbox.ru/page.php?key=ro_XXXXXX&page=news-tech-2025-09-09


Пример данных:

{
  "api_key": "{api_key}",
  "data": {
    "pages": {
      "news-tech-2025-09-09": {
        "title": "Новости технологий",
        "subtitle": "Подборка самых интересных новостей за последние дни",
        "footer": [
          {
            "type": "link",
            "label": "Наш Telegram",
            "url": "https://t.me/example"
          },
          {
            "type": "text",
            "content": "© 2025 jsonbox.ru demo"
          }
        ],
        "items": [
          { 
            "title": "OpenAI выпустила GPT-5", 
            "image": "https://.....",
            "text": "...",
            "date": "2025-09-09", 
            "author": "Tech News",
            "tags": "AI, OpenAI, GPT-5"
          }
        ]
      }
    }
  }
}

Postman коллекция

Чтобы быстрее начать работу с JsonBox API, вы можете импортировать готовую коллекцию в Postman или аналогичные инструменты (Insomnia, Hoppscotch и др).
В коллекции уже настроены основные запросы: регистрация, получение ключа, работа с данными и страничками (pages). Просто скачайте файл и импортируйте его в Postman:
ИЛИ
Репозиторий на GitHub: https://github.com/JsonBox/jsonbox-postman
Зеркало на GitFlic: https://gitflic.ru/project/jsonbox/jsonbox-postman
Зеркало на GitVerse: https://gitverse.ru/jsonbox/jsonbox-postman
После импорта вам останется только указать свой "api_key" в переменных окружения, и можно сразу отправлять запросы.
ЧТО ВКЛЮЧЕНО:
📊 Основные операции (4 запроса)
⚙️ Управление настройками (3 запроса)
🔑 Управление API ключом (1 запрос)
🌐 Веб-отображение (1 запрос)

Условия использования

  • Бесплатное использование для проектов с разумной нагрузкой
  • Лимит данных: до 1024 KB на пользователя
  • Лимит запросов: 1000 POST-запросов в день на API-ключ
  • Автоудаление: неактивные аккаунты удаляются через 30 дней
  • Запрещено: хранение вредоносного контента, спам, незаконная деятельность
  • Резервное копирование: регулярно создавайте копии важных данных
  • Поддержка: техническая поддержка по email
  • SLA: 99.5% времени работы сервиса

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

Готовые примеры кода на популярных языках программирования

import requests
import json

# Регистрация пользователя
response = requests.post(
    'https://jsonbox.ru/api.php?action=register',
    json={'email': 'user@example.com'},
    headers={'Content-Type': 'application/json'}
)

data = response.json()
api_key = data['api_key']

# Сохранение данных
store_response = requests.post(
    'https://jsonbox.ru/api.php?action=store',
    json={
        'api_key': api_key,
        'data': {
            'message': 'Hello from Python!',
            'items': [1, 2, 3]
        }
    }
)

# Получение данных
get_response = requests.get(
    f'https://jsonbox.ru/api.php?action=get&api_key={api_key}'
)

user_data = get_response.json()
print(user_data['data'])