snapchat_api 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f835d1d5764f58f10ea61e25aa7bec86ba1ff18670ec3e62461968385d3e0c08
-  data.tar.gz: edc4635f63d1811a567a8e382c395b54fb5bc19d9a3e05344c4ed2a15bcad10b
+  metadata.gz: 610ba62897a08a9423272ac199a3c0bb3d9a2e4784d7bf7eb7f3f1122b696773
+  data.tar.gz: 3cdb587109ab2340f7a765f2f0e41c83fa1e228ffbc2147ae29aea1c7036ff72
 SHA512:
-  metadata.gz: a50dcef0a90a743017da6405e26fbc4f46b551d50e7012aed4ecd7c40efe5eefcd77ee0c31193ade4d8aaab1921d753051589a68891def9a6bbc7c6a986a042d
-  data.tar.gz: b7d88ee3f394e8d0e869b7a28691fe94a2fe92414147fde541e2a1a100a02bdc6475b2f0d13804c77a34562337542d3b2c80cd337e118a910204c0c79670e82e
+  metadata.gz: 375ea46e5c1a6d95ae99655e0da9959245e62bea8294bba8c752db0cd60e41d71125003bc1f8e883ce35190d6ed2ffeacde620592816e4f0e98a34ee8123bd79
+  data.tar.gz: b4ee14a9e0207b32573609d5673b25365890fe0c2ff756f007cc82c83439aa11292fbf1d998e8a97ad5ea82e13c313c19d64cee05efd402778d14a76c7136448

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.6](https://github.com/k0va1/snapchat_api/compare/v0.1.5...v0.1.6) (2025-12-30)
+
+
+### Features
+
+* add error handling for API responses with request_status ERROR ([554d4c5](https://github.com/k0va1/snapchat_api/commit/554d4c5f8ec3545f632110875cd436de84faaac2))
+* add error handling for API responses with request_status ERROR ([6ebe619](https://github.com/k0va1/snapchat_api/commit/6ebe6190b4283678dbec9104dee051ccc25bd80f))
+
 ## [0.1.5](https://github.com/k0va1/snapchat_api/compare/v0.1.4...v0.1.5) (2025-08-25)
 
 

data/lib/snapchat_api/client.rb

@@ -135,10 +135,17 @@ module SnapchatApi
     private
 
     def handle_response(response)
+      body = response.body
+      status = response.status
+
+      # Check for request-level errors (API returns 200 but request_status is ERROR)
+      if response.success? && body.is_a?(Hash)
+        check_request_status_error(body, status)
+        return response
+      end
+
       return response if response.success?
 
-      status = response.status
-      body = response.body
       error_message = body.is_a?(Hash) ? body&.dig("message") : body
 
       klass = case status
@@ -158,5 +165,47 @@ module SnapchatApi
 
       raise klass.new(error_message || "HTTP #{status}", status, body)
     end
+
+    def check_request_status_error(body, status)
+      return unless body["request_status"] == "ERROR"
+
+      request_id = body["request_id"]
+      sub_errors = extract_sub_errors(body)
+      error_message = build_error_message(body, sub_errors)
+
+      raise SnapchatApi::RequestError.new(error_message, status, body, request_id, sub_errors)
+    end
+
+    def extract_sub_errors(body)
+      sub_errors = []
+
+      # Look for sub-request errors in various response keys
+      # The API may return errors under different keys depending on the endpoint
+      possible_keys = %w[creatives ads campaigns ad_squads media adaccounts]
+
+      possible_keys.each do |key|
+        next unless body[key].is_a?(Array)
+
+        body[key].each do |item|
+          if item.is_a?(Hash) && item["sub_request_status"] == "ERROR"
+            sub_errors << {
+              reason: item["sub_request_error_reason"],
+              status: item["sub_request_status"]
+            }
+          end
+        end
+      end
+
+      sub_errors
+    end
+
+    def build_error_message(body, sub_errors)
+      if sub_errors.any?
+        messages = sub_errors.map { |e| e[:reason] }.compact
+        messages.join("; ")
+      else
+        body["debug_message"] || body["display_message"] || "Request failed with status ERROR"
+      end
+    end
   end
 end

data/lib/snapchat_api/error.rb

@@ -2,10 +2,12 @@ module SnapchatApi
   class Error < StandardError
     attr_reader :status_code
     attr_reader :body
+    attr_reader :request_id
 
-    def initialize(message = nil, status_code = nil, body = nil)
+    def initialize(message = nil, status_code = nil, body = nil, request_id = nil)
       @status_code = status_code
       @body = body
+      @request_id = request_id
       super(message)
     end
   end
@@ -19,4 +21,14 @@ module SnapchatApi
   class ApiError < Error; end
 
   class RateLimitError < Error; end
+
+  # Raised when API returns HTTP 200 but request_status is ERROR
+  class RequestError < Error
+    attr_reader :sub_errors
+
+    def initialize(message = nil, status_code = nil, body = nil, request_id = nil, sub_errors = [])
+      @sub_errors = sub_errors
+      super(message, status_code, body, request_id)
+    end
+  end
 end

data/lib/snapchat_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SnapchatApi
-  VERSION = "0.1.5"
+  VERSION = "0.1.6"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: snapchat_api
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - Alex Koval