URL vs header API versioning?

Middle
179 просмотров
AFK Offer AI

URL versioning (/v1/users) — просто, явно, работает в браузере, кешируется CDN. Минус — меняет URI ресурса, что не по REST (ресурс один, а URI разные). Header versioning (Accept: vnd.api.v2) — REST-pure, URI не меняется. Минус — не видно в URL, сложнее тестировать curl-ом, CDN не кеширует без настройки. На практике 90% публичных API используют URL — простота побеждает чистоту. Для внутренних API — можно header.

Следующий вопрос

Как спроектировать URL shortener на Go?