同じヘッダーを毎回のリクエストに付けたいときは、set_default_headers()を使います。一度設定すれば、そのクライアントから送るすべてのリクエストに自動で付与されます。
httplib::Client cli("https://api.example.com"); cli.set_default_headers({ {"Accept", "application/json"}, {"User-Agent", "my-app/1.0"}, }); auto res = cli.Get("/users");
AcceptやUser-Agentのように、APIを呼ぶたびに必要なヘッダーをまとめて登録できます。リクエストごとに指定する手間が省けます。
httplib::Client cli("https://api.example.com"); cli.set_default_headers({ {"Authorization", "Bearer " + token}, {"Accept", "application/json"}, }); auto res1 = cli.Get("/me"); auto res2 = cli.Get("/projects");
認証トークンを一度セットしておけば、以降のリクエストで自動的に送られます。複数のエンドポイントを叩くAPIクライアントを書くときに便利です。
Note:
set_default_headers()は既存のデフォルトヘッダーを上書きします。あとから1つだけ追加したい場合でも、全体を渡し直してください。
デフォルトヘッダーを設定していても、個別のリクエストで追加のヘッダーを渡せます。
httplib::Headers headers = { {"X-Request-ID", "abc-123"}, }; auto res = cli.Get("/users", headers);
リクエスト単位で渡したヘッダーはデフォルトヘッダーに追加され、両方がサーバーに送られます。デフォルトヘッダーと同じ名前のヘッダーを渡した場合は、リクエスト単位のものだけが送られます。
Bearerトークンを使った認証の詳細はC06. BearerトークンでAPIを呼ぶを参照してください。