API REST використовують частину рядка стану повідомлення HTTP-відповіді, щоб повідомити клієнтів про загальний результат їхнього запиту. RFC 2616 визначає синтаксис рядка стану, як показано нижче: Рядок статусу = HTTP-версія SP Код стану SP Reason-Phrase CRLF HTTP визначає ці стандартні коди стану, які можна використовувати для передачі результатів запиту клієнта. Коди стану поділяються на п’ять категорій. 1xx Коди статусу [Інформаційні] Код статусу Опис […]
Кешування відповіді REST API
1. Кешування Кешування — це можливість зберігати копії даних, до яких часто звертаються, у кількох місцях на шляху запит-відповідь. Коли споживач запитує представлення ресурсу, запит проходить через кеш або серію кешів (локальний кеш, кеш-проксі-кеш або зворотний проксі-сервер) до служби, на якій розміщено ресурс. Якщо будь-який із кешів уздовж шляху запиту має свіжу копію запитаного представлення, він […]
Контроль версій REST API
Зміни в API неминучі, оскільки наші знання та досвід роботи з системою вдосконалюються. Управління впливом цієї зміни може бути досить складним, якщо вона загрожує порушити існуючи інтеграцію клієнтів. Щоб керувати проблематикою оновлень, версіюйте свій API. Контроль версій допомагає нам виконувати ітерацію швидше, коли потрібні зміни ідентифікуються в API. 1. Коли треба користувати версії? Оновлювати API потрібно лише […]
Посібник з іменування ресурсів REST
1. Що таке ресурс? У REST первинне представлення даних називається ресурсом . Наявність узгодженої та надійної стратегії іменування ресурсів REST стане одним із найкращих проектних рішень у довгостроковій перспективі. Ключовою абстракцією інформації в REST є ресурс. Будь-яка інформація, яку можна назвати, може бути ресурсом: документом або зображенням, тимчасовою службою (наприклад, «погода в Харкові зараз»), колекцією інших ресурсів, невіртуальним об’єктом (наприклад, людиною) […]
Параметр “q” в HTTP заголовку “Accept”
1. Клієнти API підтримують кілька форматів REST API може повертати представлення ресурсу в багатьох форматах – точніше, MIME-типи . Клієнтська програма або браузер може запитувати будь-який підтримуваний тип MIME у заголовку HTTP Accept . Технічно Accept Header може мати кілька значень у формі значень, розділених комами. Наприклад, Accept Header із запитом text/html або application/xml формати можна встановити як: 2. Параметр “q”. Іноді клієнти можуть […]