Перейти до вмісту

Розширювач URI-шаблонів

Розширіть URI-шаблон RFC 6570 у реальну URL-адресу, використовуючи надані змінні.

Введення
Змінні
Вихід

Розширювач URI-шаблонів

Вставте URI-шаблон — такий, як використовується в визначеннях посилань OpenAPI/Swagger, переспрямуванні OAuth, конфігураціях вебхуків та гіперпосилань API (HAL, Hydra, JSON:API) — і цей інструмент розширить його {expressions} у реальну URL-адресу. Він повністю реалізує RFC 6570, включаючи оператори шляху, рядка запиту, параметрів шляху, міток та фрагментів, тому шаблон на кшталт "/users/{id}{?fields,tags*}" розширюватиметься точно так же, як це робила б сумісна бібліотека клієнта.

Значення змінних вводяться у другу панель, по одній парі "ключ=значення" на рядок. Звичайне значення — це рядок; розгорніть список, розділений комами, у квадратні дужки ("tags=[dev,admin]") для змінних списку, і використовуйте фігурні дужки з парами, розділеними "|", ("keys={role=admin|team=core}") для змінних асоціативних (ключ-значення). Параметр рівня шаблону (1-4) перевіряє, які функції RFC 6570 насправді потребує вираз, і позначає ті, що виходять за межі вибраного рівня — корисно, якщо ви спрямовуєтеся на клієнта, який реалізує лише більш низький рівень. Кодування зарезервованих символів відсотком примусово кодує навіть в межах зазвичай ліберальних розширень "+" та "#"; пропуск порожніх змінних видаляє змінну, яка розв'язується на порожний рядок, замість того, щоб залишати параметр без значення.

Під розширеною URL-адресою інструмент завжди виводить список змінних, які були використані у шаблоні, але не були надані ("missing") та які були надані, але ніколи не використовувалися шаблоном ("unused") — найшвидший спосіб виявити друкарську помилку в шаблоні або списку змінних. Кінці рядків, модифікатори префіксу ("{var:3}") та модифікатори розгортання ("{list*}", "{keys*}") обробляються відповідно до специфікації, а неправильний шаблон (незбалансовані дужки, порожній вираз, непідтримуваний оператор) повертає зрозуміле повідомлення про помилку замість порожнього результату.

Усе працює локально у вашому браузері — шаблон та його змінні ніколи не завантажуються нікуди. Скопіюйте розширену URL-адресу, завантажте її як файл .txt або відправте її прямо в введення іншого інструменту, щоб продовжити роботу.

FAQ

Що таке URI-шаблон?
URI-шаблон (RFC 6570) — це шаблон URL-адреси з {заповідниками}, які заповнюються реальними значеннями — формат, який API використовує для документування параметризованих кінцевих точок, наприклад "/users/{id}".
Які оператори він підтримує?
Усі з них: просте розширення, "+" (зарезервовані символи дозволені), "#" (фрагмент), "." (мітка), "/" (сегменти шляху), ";" (параметри стилю шляху), "?" (рядок запиту) та "&" (продовження запиту).
Як я можу надати список або об'єкт як значення змінної?
Розгорніть список у квадратні дужки, наприклад "tags=[dev,admin]". Розгорніть об'єкт у фігурні дужки з парами, розділеними "|", наприклад "keys={role=admin|team=core}" — просте значення залишається звичайним рядком.
Що відбувається, якщо змінна, використана в шаблоні, не має значення?
Вона розширюється як порожня і виводиться під заголовком "Missing" нижче результату, щоб ви могли з першого погляду побачити, які значення вам все ще потрібно надати.
Мої URI-шаблон або дані змінних завантажуються де-небудь?
Ні. Розширення працює повністю у вашому браузері — шаблон та його змінні ніколи не залишають ваш пристрій.