jsonbox-postman

Postman-коллекция для JsonBox.ru — лёгкого REST API-сервиса для хранения JSON-данных. В коллекции собраны основные запросы: регистрация, работа с данными, управление настройками и просмотр страниц (Pages). Удобный старт для разработчиков: импортируйте и используйте API за 3 минуты.

Содержание репозитория

jsonbox-postman/
├─ examples/
│  └─ quickstart.md
├─ JsonBox_API_postman_collection.json
├─ LICENSE
└─ README.md

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

1. Скачайте файл
   JsonBox_API_postman_collection.json
   (в этом репозитории он уже есть).
2. Откройте Postman (или Insomnia / Hoppscotch) → Import → выберите файл
   JsonBox_API_postman_collection.json
   .
3. Создайте окружение (Environment) и добавьте переменную
   api_key
   .
   • Для просмотра страниц (
     page.php
     ) используйте read‑only ключ, начинающийся с
     ro_
     (пример:
     ro_abc123...
     ).
   • Для операций записи (store/delete/set_setting и т.п.) используйте полный
     api_key
     (необязательно для Page-view, и возможно отключён для этой фичи — см. ниже про безопасность).

Примечание: страничный просмотр (

page.php

) безопасно работает только с ключом только для чтения —

api_key_read_only

(префикс

ro_

). Полный ключ не будет работать для публичного веб-рендера по соображениям безопасности.

Переменные Postman

• api_key
  — основной placeholder, используемый в коллекции. Замените на ваш
  ro_...
  или
  api_key
  .

Ключевые запросы (коротко)

Сохранить данные

POST https://jsonbox.ru/api.php?action=store
Content-Type: application/json

{
  "api_key": "YOUR_FULL_API_KEY",
  "data": { ... }
}

Получить данные

GET https://jsonbox.ru/api.php?action=get&api_key=YOUR_API_KEY

Удалить данные

DELETE https://jsonbox.ru/api.php?action=delete
Content-Type: application/json

{ "api_key": "YOUR_FULL_API_KEY" }

Настройки

• Получить все настройки:

GET https://jsonbox.ru/api.php?action=get_settings&api_key=YOUR_API_KEY

• Изменить настройку (например, включить/выключить веб-отображение или поставить тему):

POST https://jsonbox.ru/api.php?action=set_setting
Content-Type: application/json

{
  "api_key": "YOUR_FULL_API_KEY",
  "setting_name": "web_display_enabled",
  "setting_value": "false"
}

Перегенерировать ключ

POST https://jsonbox.ru/api.php?action=regenerate_key
Content-Type: application/json

{ "api_key": "YOUR_FULL_API_KEY" }

Просмотр как веб-страницы (Pages)

https://jsonbox.ru/page.php?key=ro_YOUR_READ_ONLY_KEY&page=PAGE_SLUG

• page
  — необязательный параметр; если не указан — показывается первая страница из массива
  pages
  .
• Обязательно используйте ключ
  ro_...
  (read-only). Полный ключ для этой операции не используется/не поддерживается по соображениям безопасности.