Підключення

П’ять кроків. Перші три робить оператор сервісу, останні два — ви в себе.

1. Домен

Виберіть піддомен, з якого віддаватимуться файли — наприклад img.вашдомен, — і заведіть на нього A-запис, який дасть оператор. Домен оголошується канонічним: саме з нього сервіс збирає адреси у відповідях.

Доменів в орендаря може бути скільки завгодно, але канонічний рівно один. Інакше один файл отримає дві адреси, а отже і два кеші, і два завантаження на телефоні читача.

Власний домен можна й не підключати: тоді файли віддаються зі спільного keepix.cloud. Обидві дороги працюють однаково.

2. Види й варіанти

Вид (kind) — це те, до якого роду належить файл: prodimg для каталожних картинок, review для світлин відгуків, і так далі. Для кожного виду оголошується, які варіанти йому належать.

Заразом призначаються стелі: розмір одного файлу, число завантажень на хвилину і загальний обсяг.

3. Ключі підпису

Ви отримуєте два ключі — ідентифікатор і секрет до кожного. Два, а не один, щоб зміна ключа не була простоєм: новий уводиться в дію, поки старий ще діє, і лише потім гаситься.

Секрет показується один раз. Зберігайте його там само, де решту секретів проєкту, і ніколи не передавайте в командному рядку.

4. Перший файл

Надішліть оригінал і збережіть адреси з відповіді поруч із записом, до якого файл належить.

POST /api/v1/put?kind=prodimg&key=<ваш ідентифікатор>&variants=card,full

Якщо у вас уже накопичені готові копії — їх можна перенести без перекодування через put-variant. Перекодувати готове вдруге означає втратити якість на рівному місці.

Одне місце в коді, а не чотири. Підставляйте збережену адресу в одній функції, через яку ходять усі вітрини. Якщо умову «локально чи на сервісі» розмазати по чотирьох сторінках, вони розійдуться на першій же правці — і розійдуться мовчки.

5. Сторож

Заведіть перевірку, яка ходить тим самим шляхом, що й вітрина: питає в сервісу відомий об’єкт і звіряє чотири речі — відповідь 200, тип вмісту, ненульову довжину і що адреса збіглася з тією, яка записана у вас.

Останнє важливіше за решту. Якщо розкладка зміниться, а ви не помітите, картинки зникнуть мовчки: сторінка відмалюється, а на місці товару буде діра.

І перевірте сторожа зламавши щось навмисне — підмініть записану адресу й переконайтеся, що він лається. Сторож, який ніколи не спрацьовував, — це не сторож, а рядок у конфігу.

Що робити, якщо запис загубився

Спитати, а не вгадати:

GET  /api/v1/resolve?kind=prodimg&key=48120
POST /api/v1/resolve-batch     {"kind":"prodimg","keys":["1","2","…"]}   ← до 1000 ключів

Сервіс на те й зберігає адреси, щоб їх не доводилося виводити за правилом.