リクエストヘッダとパラメータを付与してPOSTでAPIにアクセスしたい（gem/httpclientを使用）

Question

前提・実現したいこと

Rubyのgem・httpclientを使用して、タイトルの通り、
リクエストヘッダとパラメータを追加した上でAPIにPOSTメソッドでアクセスしたいと考えています。

なお、他のgemを使用する等により確実に実行できる方法がございましたら、そちらでも構いません。

つまずいている箇所

httpclientのライブラリを参照しましたが解説が不十分で、どのメソッドをどのように使用すれば良いかわかりませんでした。
https://github.com/nahi/httpclient

該当のソースコード

  URL = 略
  USER = 略
  PASSWORD = 略

  def get_hoge
    c = HTTPClient.new()
    c.set_auth(URL, USER, PASSWORD)
    res = c.post_content(URL, {
      'HOGE' => "FUGA"
    })
    res
  end

リクエストヘッダのフィールド名：HOGE、値：FUGA　に加えて、
パラメータとして　hoge: fuga　を付与してアクセスしたいと考えています。

試したこと

上記の通りpost_contentメソッドを使用してみましたが、
リクエストヘッダとパラメータを同時に記述する方法が分かりませんでした。

補足情報（FW/ツールのバージョンなど）

Railsのバージョン：5.2.0
httpclientのバージョン：2.8.3

よろしくお願いいたします。

Answer 1

ドキュメントをきちんと読んでいないだけのように思えます。
内容はこれで十分でしょう。

https://github.com/nahi/httpclient には、
「See HTTPClient for documentation.」と書かれており、
ドキュメントへのリンクがあります。

例えば、HttpCliene#post_contentメソッドのドキュメントを見れば、
パラメータ(body)とヘッダ(header)の指定方法は明らかです。
https://www.rubydoc.info/gems/httpclient/HTTPClient#post_content-instance_method

body, headerを指定する例

client = HTTPClient.new
uri = 'http://...'
params = {
  a: 1,
  b: 2
}
headers = {
  'User-Agent' => 'Sample/RubyClient/1.0'
}
content = client.post_content(uri, body: params, header: headers)

---

postメソッドの例

client = HTTPClient.new
uri = 'http://...'
params = {
  a: 1,
  b: 2
}
headers = {
  'User-Agent' => 'Sample/RubyClient/1.0'
}
# postの戻り値はHTTP::Messageのインスタンス
response = client.post(uri, body: params, header: headers)

response.body => レスポンスボディ文字列
response.status => HTTPステータス(200,400などの数値)
response.headers => レスポンスヘッダのHash

Comments

[kotahayashi]

ご回答くださりありがとうございます。
私が初心者である旨と、以下の旨を記述するべきでした。質問に不備があり申し訳ございません。

当然こちらのドキュメントを参照した上で、post_contentメソッドが使えるのではないかという判断に至りました。
しかし、bodyとheaderの記述方法が同じように見え、どのような形で併記すればそれぞれbody, headerとしてカスタムできるのか分かりませんでした。再度思案しましたが、まだ見当がつきません。

私の判断に自信がなかったことと、回答率をあげる等の点から抽象度を高めて質問をしましたが、このような形となりお手数をおかけしました。

[mingos]

今回の件では、post_contentのドキュメントURLを質問に明記して、内容が理解できないという事を簡潔に書いたほうが回答してもらいやすいと思います。
整理すると、post_contentのドキュメントにあるbody, headerの指定方法が分からないという事のようですので、回答にて例を示します。

なお、post_contentではresponse bodyだけを取得するメソッドなので汎用性が低いので、実用するならばpostを使うべきかなと思います。

[kotahayashi]

別の部分にミスがあり検証に時間がかかってしまいましたが、お示しいただいたコードの書き方でアクセスできました。
質問のしかたについてもアドバイスいただき、ありがとうございました。