Быстрый старт
От нуля до подписанной ссылки примерно за пять минут. Нужен ключ доступа из консоли.
1. Ключ в переменную
export OBJECTBASIN_KEY="ob_live_xxxxxxxxxxxxxxxxxxxx"
2. Создать бакет
curl -X PUT https://api.objectbasin.com/v1/buckets/media \ -H "Authorization: Bearer $OBJECTBASIN_KEY"
{"bucket":"media","region":"eu-central","node":"fra1","created":"2026-09-22T21:04:11Z"}
3. Загрузить объект
curl -X PUT https://api.objectbasin.com/v1/buckets/media/objects/2026/hero.jpg \ -H "Authorization: Bearer $OBJECTBASIN_KEY" \ -H "Content-Type: image/jpeg" \ --data-binary @hero.jpg
Файлы больше 100 МБ стоит грузить через multipart — клиентские библиотеки делают это сами.
4. Подписанная ссылка
curl "https://api.objectbasin.com/v1/buckets/media/objects/2026/hero.jpg/sign?expires=3600" \
-H "Authorization: Bearer $OBJECTBASIN_KEY"
{"url":"https://media.objectbasin.com/2026/hero.jpg?token=...","expires_in":3600}
Если что-то не работает
| Симптом | Вероятная причина |
|---|---|
401 invalid_key | Ключ отозван или скопирован с пробелом. |
403 signature_mismatch | SigV4-клиент подписывает не тот хост — нужен api.objectbasin.com. |
413 object_too_large | Одиночный PUT больше 5 ГиБ — переходите на multipart. |
| Чтение медленнее обычного | Холодный диапазон: проверьте x-objectbasin-region и повторите чтение. |