JSON Storage API — это REST API, который позволяет загружать JSON-файлы, получать публичную ссылку на них и делиться данными с кем угодно.
Файлы можно создавать, обновлять и удалять через REST API или через встроенный Playground на странице API. В будущем также появится возможность загружать JSON-файлы через личный кабинет.
Возможности и лимиты#
Можно загрузить до 3 JSON-файлов.
Размер каждого файла — не более 50 KB.
Публичное чтение JSON-файла доступно без API-ключа и без лимита на количество запросов.
Лимит есть только на управление файлами: создание, изменение и удаление. Для этих действий действует ограничение 10 запросов в минуту. Это сделано специально, чтобы не перегружать сервер операциями с файлами.
Когда это может быть полезно#
JSON Storage API удобно использовать для:
- хранения моковых данных
- demo-проектов
- тестовых заданий
- подготовки заданий для кандидатов на интервью
- публичных JSON-конфигов
- быстрого шаринга JSON-файлов
- frontend-примеров без собственного backend
Создание JSON-файла через API#
Для создания файла нужно отправить POST - запрос на:
Body принимает 2 параметра:
data— JSON-данныеname— название файла
Пример REST API:
Пример ответа:
Где:
name— название вашего файлаurl— публичная ссылка на JSON-файлviewerUrl— страница для удобного просмотра файла
На странице viewerUrl можно посмотреть размер файла, публичный URL, скачать файл и открыть предпросмотр JSON.
Просмотр всех JSON-файлов#
Вы можете посмотреть все свои файлы через Playground на странице API или через REST API.
Пример REST API:
Пример ответа:
Удаление JSON-файла#
Файл можно удалить через Playground или через REST API.
URL для удаления выглядит так:
name — название файла
Пример REST API:
Playground#
JSON Storage API можно тестировать не только через код, но и через встроенный Playground на странице API.
Это удобно, если нужно быстро загрузить файл, посмотреть список доступных JSON-файлов, удалить ненужный файл или просто проверить структуру ответа без отдельного клиента.