[B! http][api] bojovsのブックマーク

HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様

今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための（レスポンスボディに載せられる）標準的な形式が、RFC7807 Probl em Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application

bojovs 2017/01/06

http
api

リンク

トークンを利用した認証・認可 API を実装するとき Authorization: Bearer ヘッダを使っていいのか調べた - Qiita

トークンを利用した認証・認可 API を実装するとき Authorization: Bearer ヘッダを使っていいのか調べたAPIOAuthWeb TL;DR HTTP でトークンを利用した認証・認可をする手法として RFC 6750 がある OAuth に限らず、トークンを利用して認証・認可する機構の一部として Authorization: Bearer ヘッダを使うことができる使い方について詳しくはこの記事の下のほうに書いた要求トークンを利用した認証・認可機構を持つ API を作りたいクライアントがトークンを HTTP リクエストに含めて送信し、サーバはトークンを検証してリソースへのアクセスを許可したい Authorization: Bearer トークンヘッダでトークンを送る API あるよね、ああいうやつ疑問 Authorization: Bearer ヘッダは OA

bojovs 2015/10/11

http
api

リンク

Httphub - What you POST is what you GET

Register to get your namespace, in the following format: https://username.httphub.com https://username.httphub.com/logs/ https://username.httphub.com/private/ https://username.httphub.com/shared/ https://username.httphub.com/users/ later, when you create users in your namespace you get also (for "jane" user): https://username.httphub.com/users/jane/private/ https://username.httphub.com/users/jane/

bojovs 2015/01/14

リンク

Indicating Problems in HTTP APIs

Hi, I’m Mark Nottingham. I write about the Web, protocol design, HTTP, Internet governance, and more. This is a personal blog, it does not represent anyone else. Find out more. Comments? Let's talk on Mastodon. @mnot@techpolicy.social other HTTP APIs posts Designing Headers for HTTP Compression Tuesday, 27 November 2018 How to Think About HTTP Status Codes Thursday, 11 May 2017 Five Reasons to Con