From 5db93efb6b4e4e5edbb4bb864e85ccdcc912e894 Mon Sep 17 00:00:00 2001
From: gngpp <gngppz@gmail.com>
Date: Fri, 10 Jul 2026 05:57:05 +0800
Subject: [PATCH] Document response headers API

---
 lib/wreq_ruby/response.rb | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/lib/wreq_ruby/response.rb b/lib/wreq_ruby/response.rb
index d1194a1..e019226 100644
--- a/lib/wreq_ruby/response.rb
+++ b/lib/wreq_ruby/response.rb
@@ -64,6 +64,17 @@ def url
       def content_length
       end
 
+      # Get the response headers.
+      #
+      # Header names are case-insensitive. Use {Wreq::Headers#get_all} to get
+      # every value when a header appears more than once.
+      #
+      # @return [Wreq::Headers] Response headers
+      # @example
+      #   response.headers.get("content-type")  # => "application/json"
+      def headers
+      end
+
       # Get the local socket address.
       #
       # @return [String, nil] Local address (e.g., "127.0.0.1:54321"), or nil