tiktok-open-sdk 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49fd72cee8903953251d98a9bd2952e08e11ebb480df678a3758214bc6aed326
-  data.tar.gz: 53887f2fce24bf2784762a9a44acc497e5c6209eabcdc2c41809ec9b40f60016
+  metadata.gz: 5baf485e6b6be4c1d0541f8d8d3ff76232bba37253fe7e6d89a6a9359328dc04
+  data.tar.gz: 398eb5072ac7be7fd647679f408ecfa94fce22ff44c4993bf1891637d7cc6150
 SHA512:
-  metadata.gz: 50bd4af46c1e7a05bdcfec937eb040e7d078ebc5b3a951fd1288cdb824fb32a20453e2e4527f9642345c4aefa6b9c9c83306dea78ee166e1c86b07bad6f0ceb2
-  data.tar.gz: 8a8d4b6827e25a81720b30aee2f296fbaf0b328a0a57c7c9a3286c49de3e338a274b3b65f9b39bc67846113612542a5e7b22e74db99eda68d011519441077195
+  metadata.gz: e3ade7fbfaaea010568b79c807b52d65fa4398f486889387ab07a01db54163021a410d77a76552f865599b32db2d40cd89c19df11964ebc83a19022d163887d3
+  data.tar.gz: b512cb261c7b577a74523b501a25daddce2e1196f90ebc9351cf1472516f33fb1634bd1b501bd04649cdb10c44c9c97513fd0a0474de533bba59f8e1eb15c530

data/.yardopts

@@ -0,0 +1,12 @@
+--markup markdown
+--markup-provider redcarpet
+--output-dir doc/
+--no-private
+--protected
+--exclude spec/
+--exclude coverage/
+--exclude tmp/
+--exclude pkg/
+--exclude .github/
+--title "TikTok Open SDK Documentation"
+--main README.md

data/CHANGELOG.md

@@ -6,6 +6,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2025-09-20
+### Added
+- User information retrieval from TikTok API
+- Improved request validation and error handling
+
 ## [0.2.0] - 2025-09-17
 ### Added
 - Support for obtaining a client access token directly from the TikTok Open API, enabling secure server-to-server authentication for backend integrations and service authentication flows.

data/README.md

@@ -1,6 +1,6 @@
 # TikTok Open SDK
 
-[![Gem Version](https://img.shields.io/badge/gem-v0.2.0-blue.svg)](https://rubygems.org/gems/tiktok-open-sdk)
+[![Gem Version](https://img.shields.io/badge/gem-v0.3.0-blue.svg)](https://rubygems.org/gems/tiktok-open-sdk)
 [![Ruby Version](https://img.shields.io/badge/ruby-%3E%3D%203.0.0-red.svg)](https://www.ruby-lang.org/en/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE.txt)
 [![CI](https://github.com/pochkuntaras/tiktok-open-sdk/actions/workflows/main.yml/badge.svg)](https://github.com/pochkuntaras/tiktok-open-sdk/actions/workflows/main.yml)
@@ -12,6 +12,7 @@ A comprehensive Ruby SDK for integrating with TikTok Open API. This gem provides
 - **OAuth 2.0 Authentication** – Seamless OAuth flow for secure integration
 - **Client Authentication** – Server-to-server authentication with client credentials
 - **Token Management** – Easy access token exchange and refresh
+- **User API** – Convenient methods to access user information
 - **HTTP Client** – Built-in client for interacting with TikTok APIs
 
 ## Installation
@@ -54,6 +55,7 @@ Tiktok::Open::Sdk.configure do |config|
   config.user_auth.auth_url         = 'https://www.tiktok.com/v2/auth/authorize/'
   config.user_auth.token_url        = 'https://open.tiktokapis.com/v2/oauth/token/'
   config.user_auth.revoke_token_url = 'https://open.tiktokapis.com/v2/oauth/revoke/'
+  config.user_info_url              = 'https://open.tiktokapis.com/v2/user/info/'
 end
 ```
 
@@ -156,12 +158,41 @@ end
 
 **Note:** Client tokens are used for server-to-server authentication and have different scopes and permissions than user tokens.
 
+### Using the User API
+
+The SDK provides a convenient way to access user information:
+
+```ruby
+# Get user information
+response = Tiktok::Open::Sdk::OpenApi::User.get_user_info(
+  access_token: access_token,
+  fields: %w[open_id union_id avatar_url display_name]
+)
+
+if response[:success]
+  user_data = response[:response][:data][:user]
+  
+  puts "User ID: #{user_data[:open_id]}"
+  puts "Display Name: #{user_data[:display_name]}"
+else
+  puts "Error: #{response[:response][:error][:message]}"
+end
+```
+
+Available user fields include:
+- `open_id` - User's Open ID
+- `union_id` - User's Union ID
+- `avatar_url` - User's avatar URL
+- `display_name` - User's display name
+- `username` - User's username
+- And more (see documentation for full list)
+
 ### Using the HTTP Client
 
 The SDK includes a flexible HTTP client for making API calls:
 
 ```ruby
-# GET request
+# GET request using request method
 response = Tiktok::Open::Sdk::HttpClient.request(
   :get,
   'https://open.tiktokapis.com/v2/user/info/',
@@ -173,6 +204,17 @@ response = Tiktok::Open::Sdk::HttpClient.request(
   }
 )
 
+# GET request using get method
+response = Tiktok::Open::Sdk::HttpClient.get(
+  'https://open.tiktokapis.com/v2/user/info/',
+  params: {
+    fields: 'open_id,union_id,avatar_url'
+  },
+  headers: {
+    'Authorization' => "Bearer #{access_token}"
+  }
+)
+
 # POST request
 response = Tiktok::Open::Sdk::HttpClient.post(
   'https://open.tiktokapis.com/v2/video/list/',
@@ -241,6 +283,18 @@ class TiktokAuthController < ApplicationController
       session[:tiktok_access_token]  = token_data[:access_token]
       session[:tiktok_refresh_token] = token_data[:refresh_token]
       
+      # Fetch user information
+      user_response = Tiktok::Open::Sdk::OpenApi::User.get_user_info(
+        access_token: token_data[:access_token],
+        fields: %w[open_id display_name avatar_url]
+      )
+      
+      if user_response[:success]
+        user_data = user_response[:response][:data][:user]
+        session[:tiktok_user_name] = user_data[:display_name]
+        session[:tiktok_avatar] = user_data[:avatar_url]
+      end
+      
       redirect_to dashboard_path, notice: 'Successfully connected to TikTok!'
     else
       redirect_to root_path, alert: 'Failed to authenticate with TikTok'
@@ -276,6 +330,7 @@ Tiktok::Open::Sdk.configure do |config|
   config.client_secret          = 'your_client_secret' # Required
   config.user_auth.scopes       = %w[user.info.basic]  # Optional
   config.user_auth.redirect_uri = 'https://...'        # Optional
+  config.user_info_url          = 'https://open.tiktokapis.com/v2/user/info/' # Optional
 end
 ```
 
@@ -341,6 +396,35 @@ Obtains a client access token for server-to-server authentication.
 }
 ```
 
+### User API
+
+#### `get_user_info(access_token:, fields:, validate: true)`
+
+Retrieves user information from the TikTok Open API.
+
+**Parameters:**
+- `access_token` (String, required) - OAuth2 access token for authentication
+- `fields` (Array<String>, required) - User fields to retrieve (must be valid fields)
+- `validate` (Boolean, optional) - Whether to validate the token and fields (default: true)
+
+**Returns:** Hash with `:success`, `:code`, and `:response` keys
+
+**Available Fields:**
+- `open_id` - The unique identification of the user in the current application.Open id for the client
+- `union_id` - The unique identification of the user across different apps for the same developer. For example, if a partner has X number of clients, it will get X number of open_id for the same TikTok user, but one persistent union_id for the particular user
+- `avatar_url` - User's profile image
+- `avatar_url_100` - User`s profile image in 100x100 size
+- `avatar_large_url` - User's profile image with higher resolution
+- `display_name` - User's profile name
+- `bio_description` - User's bio description if there is a valid one
+- `profile_deep_link` - The link to user's TikTok profile page
+- `is_verified` - Whether TikTok has provided a verified badge to the account after confirming that it belongs to the user it represents
+- `username` - User's username
+- `follower_count` - User's followers count
+- `following_count` - The number of accounts that the user is following
+- `likes_count` - The total number of likes received by the user across all of their videos
+- `video_count` - The total number of publicly posted videos by the user
+
 ### HTTP Client
 
 #### `request(method, url, params: {}, headers: {}, body: nil)`
@@ -356,6 +440,17 @@ Performs HTTP requests.
 
 **Returns:** `Net::HTTPResponse` object
 
+#### `get(url, params: {}, headers: {})`
+
+Convenience method for GET requests.
+
+**Parameters:**
+- `url` (String) - Request URL
+- `params` (Hash, optional) - Query parameters
+- `headers` (Hash, optional) - HTTP headers
+
+**Returns:** `Net::HTTPResponse` object
+
 #### `post(url, params: {}, headers: {}, body: nil)`
 
 Convenience method for POST requests.

data/lib/tiktok/open/sdk/config.rb

@@ -13,44 +13,61 @@ module Tiktok
       #   config.client_secret = 'your_secret'
       #   config.user_auth.scopes = %w[user.info.basic]
       class Config
-        # @return [String] The TikTok client key.
+        # Base domains for constructing TikTok API URLs.
+        AUTH_BASE_URL     = 'https://www.tiktok.com'
+        OPEN_API_BASE_URL = 'https://open.tiktokapis.com'
+
+        # @!attribute [rw] client_key
+        #   @return [String] TikTok client key.
         attr_accessor :client_key
 
-        # @return [String] The TikTok client secret.
+        # @!attribute [rw] client_secret
+        #   @return [String] TikTok client secret.
         attr_accessor :client_secret
 
-        # @return [UserAuth] The user authentication configuration.
+        # @!attribute [rw] user_info_url
+        #   @return [String] TikTok user info endpoint URL.
+        attr_accessor :user_info_url
+
+        # @!attribute [rw] user_auth
+        #   @return [UserAuth] User authentication configuration.
         attr_accessor :user_auth
 
-        # Initializes a new Config object with default user authentication settings.
+        # Create a new Config with default user authentication settings.
         def initialize
-          @user_auth = UserAuth.new
+          @user_info_url = "#{OPEN_API_BASE_URL}/v2/user/info/"
+          @user_auth     = UserAuth.new
         end
 
         # User authentication configuration for TikTok Open SDK.
         #
         # Holds OAuth URLs, scopes, and redirect URI.
         class UserAuth
-          # @return [String] The OAuth authorization URL.
+          # @!attribute [rw] auth_url
+          #   @return [String] OAuth authorization URL.
           attr_accessor :auth_url
 
-          # @return [String] The OAuth token exchange URL.
-          attr_accessor :token_url
-
-          # @return [String] The OAuth token revoke URL.
+          # @!attribute [rw] revoke_token_url
+          #   @return [String] OAuth token revocation URL.
           attr_accessor :revoke_token_url
 
-          # @return [Array<String>] The list of OAuth scopes.
+          # @!attribute [rw] token_url
+          #   @return [String] OAuth token exchange URL.
+          attr_accessor :token_url
+
+          # @!attribute [rw] scopes
+          #   @return [Array<String>] List of OAuth scopes.
           attr_accessor :scopes
 
-          # @return [String, nil] The OAuth redirect URI.
+          # @!attribute [rw] redirect_uri
+          #   @return [String, nil] OAuth redirect URI.
           attr_accessor :redirect_uri
 
           # Initializes a new UserAuth object with default URLs and empty scopes.
           def initialize
-            @auth_url         = 'https://www.tiktok.com/v2/auth/authorize/'
-            @revoke_token_url = 'https://open.tiktokapis.com/v2/oauth/revoke/'
-            @token_url        = 'https://open.tiktokapis.com/v2/oauth/token/'
+            @auth_url         = "#{AUTH_BASE_URL}/v2/auth/authorize/"
+            @revoke_token_url = "#{OPEN_API_BASE_URL}/v2/oauth/revoke/"
+            @token_url        = "#{OPEN_API_BASE_URL}/v2/oauth/token/"
             @scopes           = []
             @redirect_uri     = nil
           end

data/lib/tiktok/open/sdk/helpers/auth_helper.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Tiktok
+  module Open
+    module Sdk
+      module Helpers
+        # Shared authentication helper methods for TikTok Open SDK auth modules.
+        module AuthHelper
+          private
+
+          # Returns the HTTP headers for requests.
+          #
+          # @return [Hash] The headers for HTTP requests.
+          def headers
+            {
+              'Content-Type':  'application/x-www-form-urlencoded',
+              'Cache-Control': 'no-cache'
+            }
+          end
+
+          # Returns the client credentials for authentication.
+          #
+          # @return [Hash] The client credentials.
+          def credentials
+            {
+              client_key:    Tiktok::Open::Sdk.config.client_key,
+              client_secret: Tiktok::Open::Sdk.config.client_secret
+            }
+          end
+
+          # Returns the default query parameters for the authorization URI.
+          #
+          # @return [Hash] The default query parameters:
+          #   - :client_key [String] The TikTok client key.
+          #   - :response_type [String] Always 'code'.
+          #   - :scope [String] Comma-separated scopes.
+          #   - :redirect_uri [String] The redirect URI.
+          #   - :state [nil] Default state is nil.
+          def authorization_uri_default_params
+            {
+              client_key:    Tiktok::Open::Sdk.config.client_key,
+              response_type: 'code',
+              scope:         Tiktok::Open::Sdk.config.user_auth.scopes.join(','),
+              redirect_uri:  Tiktok::Open::Sdk.config.user_auth.redirect_uri,
+              state:         nil
+            }
+          end
+
+          # render_response moved to ::Tiktok::Open::Sdk::ResponseHelpers
+        end
+      end
+    end
+  end
+end

data/lib/tiktok/open/sdk/helpers/response_helper.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Tiktok
+  module Open
+    module Sdk
+      module Helpers
+        # Helper methods for formatting HTTP responses across the SDK.
+        module ResponseHelper
+          include ::Tiktok::Open::Sdk::Helpers::StringUtilsHelper
+
+          # Parses and formats the HTTP response.
+          #
+          # @param response [Net::HTTPResponse] The HTTP response object.
+          # @return [Hash] The formatted response with keys:
+          #   - :success [Boolean] Whether the response is a Net::HTTPSuccess.
+          #   - :code [Integer] HTTP status code.
+          #   - :response [Hash] Parsed JSON body or a hash with the raw string if parsing fails.
+          def render_response(response)
+            {
+              success:  response.is_a?(Net::HTTPSuccess),
+              code:     response.code.to_i,
+              response: parse_json(response.body)
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tiktok/open/sdk/helpers/string_utils_helper.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Tiktok
+  module Open
+    module Sdk
+      module Helpers
+        # Utility methods for string and JSON handling.
+        module StringUtilsHelper
+          # Parses a JSON string into a Ruby hash with symbolized keys.
+          #
+          # @param str [String] JSON string to parse.
+          # @return [Hash] Parsed hash with symbolized keys, or a hash with the raw string if parsing fails.
+          def parse_json(str)
+            JSON.parse(str, symbolize_names: true)
+          rescue JSON::ParserError
+            { raw: str }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tiktok/open/sdk/helpers/validators/token_validator.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Tiktok
+  module Open
+    module Sdk
+      module Helpers
+        module Validators
+          # Provides token validation methods for TikTok Open SDK.
+          module TokenValidator
+            # Regular expression to validate tokens.
+            # Ensures the token consists of at least 10 printable characters.
+            TOKEN_REGEX = /\A[[:print:]]{10,}\z/
+
+            # Checks if the given token is a valid string of at least 10 printable characters.
+            #
+            # @param token [String] The token to check.
+            # @return [Boolean] true if the token is valid, false otherwise.
+            def valid_token?(token)
+              token.is_a?(String) && !token.empty? && TOKEN_REGEX.match?(token)
+            end
+
+            # Validates the given token and raises an error if it is invalid.
+            #
+            # @param token [String] The token to validate.
+            # @raise [::Tiktok::Open::Sdk::RequestValidationError] if the token is invalid.
+            # @return [void]
+            def validate_token!(token)
+              return if valid_token?(token)
+
+              raise ::Tiktok::Open::Sdk::RequestValidationError,
+                    'Invalid token format: must be at least 10 printable characters.'
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tiktok/open/sdk/http_client.rb

@@ -13,8 +13,6 @@ module Tiktok
       module HttpClient
         extend self
 
-        include StringUtils
-
         # Supported HTTP methods.
         SUPPORTED_METHODS = %i[get post].freeze
 
@@ -53,6 +51,16 @@ module Tiktok
           request(:post, url, params: params, headers: headers, body: body)
         end
 
+        # Performs a GET HTTP request.
+        #
+        # @param url [String] The request URL.
+        # @param params [Hash] Query parameters.
+        # @param headers [Hash] HTTP headers.
+        # @return [Net::HTTPResponse] The HTTP response object.
+        def get(url, params: {}, headers: {})
+          request(:get, url, params: params, headers: headers)
+        end
+
         private
 
         # Ensures the HTTP method is supported.

data/lib/tiktok/open/sdk/open_api/auth/client.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'uri'
-
 module Tiktok
   module Open
     module Sdk
@@ -11,7 +9,8 @@ module Tiktok
           module Client
             extend self
 
-            include Helpers
+            include ::Tiktok::Open::Sdk::Helpers::AuthHelper
+            include ::Tiktok::Open::Sdk::Helpers::ResponseHelper
 
             # Fetches a client access token from the TikTok Open API.
             #

data/lib/tiktok/open/sdk/open_api/auth/user.rb

@@ -11,7 +11,8 @@ module Tiktok
           module User
             extend self
 
-            include Helpers
+            include ::Tiktok::Open::Sdk::Helpers::AuthHelper
+            include ::Tiktok::Open::Sdk::Helpers::ResponseHelper
 
             # Constructs the TikTok OAuth authorization URI.
             #

data/lib/tiktok/open/sdk/open_api/user.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+# Provides methods to interact with TikTok Open API user endpoints.
+module Tiktok
+  module Open
+    module Sdk
+      module OpenApi
+        # Provides user-related methods for the TikTok Open API.
+        module User
+          # List of valid user info fields that can be requested from the API.
+          FIELDS = %w[
+            open_id
+            union_id
+            avatar_url
+            avatar_url_100
+            avatar_large_url
+            display_name
+            bio_description
+            profile_deep_link
+            is_verified
+            username
+            follower_count
+            following_count
+            likes_count
+            video_count
+          ].freeze
+
+          extend self
+
+          include ::Tiktok::Open::Sdk::Helpers::ResponseHelper
+          include ::Tiktok::Open::Sdk::Helpers::Validators::TokenValidator
+
+          # Retrieves user information from the TikTok Open API.
+          #
+          # @param access_token [String] OAuth2 access token for authentication.
+          # @param fields [Array<String>] User fields to retrieve. Must be a subset of FIELDS.
+          # @param validate [Boolean] Whether to validate the token and fields. Defaults to true.
+          # @return [Hash] Parsed API response containing user information.
+          # @raise [::Tiktok::Open::Sdk::RequestValidationError] If the access token or any requested field is invalid.
+          def get_user_info(access_token:, fields:, validate: true)
+            if validate
+              validate_token!(access_token)
+              validate_fields!(fields)
+            end
+
+            render_response Tiktok::Open::Sdk::HttpClient.get(
+              Tiktok::Open::Sdk.config.user_info_url,
+              params:  {
+                fields: fields.join(',')
+              },
+              headers: {
+                Authorization: "Bearer #{access_token}"
+              }
+            )
+          end
+
+          private
+
+          # Ensures all requested fields are supported by the API.
+          #
+          # @param fields [Array<String>] Fields to validate against FIELDS.
+          # @raise [::Tiktok::Open::Sdk::RequestValidationError] If any field is not supported.
+          def validate_fields!(fields)
+            invalid = fields - FIELDS
+
+            return if invalid.empty?
+
+            raise ::Tiktok::Open::Sdk::RequestValidationError, "Invalid fields: #{invalid.join(", ")}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tiktok/open/sdk/version.rb

@@ -3,7 +3,7 @@
 module Tiktok
   module Open
     module Sdk
-      VERSION = '0.2.0'
+      VERSION = '0.3.0'
     end
   end
 end

data/lib/tiktok/open/sdk.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
-require_relative 'sdk/string_utils'
-
-require_relative 'sdk/open_api/auth/helpers'
+require_relative 'sdk/helpers/string_utils_helper'
+require_relative 'sdk/helpers/response_helper'
+require_relative 'sdk/helpers/auth_helper'
+require_relative 'sdk/helpers/validators/token_validator'
 require_relative 'sdk/open_api/auth/user'
 require_relative 'sdk/open_api/auth/client'
+require_relative 'sdk/open_api/user'
 require_relative 'sdk/version'
 require_relative 'sdk/http_client'
 require_relative 'sdk/config'
@@ -19,6 +21,8 @@ module Tiktok
       #   raise Tiktok::Open::Sdk::Error, "Something went wrong"
       class Error < StandardError; end
 
+      class RequestValidationError < Error; end
+
       class << self
         # SDK configuration object
         #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tiktok-open-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Taras Pochkun
@@ -20,6 +20,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".tool-versions"
+- ".yardopts"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
@@ -27,11 +28,14 @@ files:
 - Rakefile
 - lib/tiktok/open/sdk.rb
 - lib/tiktok/open/sdk/config.rb
+- lib/tiktok/open/sdk/helpers/auth_helper.rb
+- lib/tiktok/open/sdk/helpers/response_helper.rb
+- lib/tiktok/open/sdk/helpers/string_utils_helper.rb
+- lib/tiktok/open/sdk/helpers/validators/token_validator.rb
 - lib/tiktok/open/sdk/http_client.rb
 - lib/tiktok/open/sdk/open_api/auth/client.rb
-- lib/tiktok/open/sdk/open_api/auth/helpers.rb
 - lib/tiktok/open/sdk/open_api/auth/user.rb
-- lib/tiktok/open/sdk/string_utils.rb
+- lib/tiktok/open/sdk/open_api/user.rb
 - lib/tiktok/open/sdk/version.rb
 - sig/tiktok/open/sdk.rbs
 homepage: https://github.com/pochkuntaras/tiktok-open-sdk
@@ -43,6 +47,7 @@ metadata:
   source_code_uri: https://github.com/pochkuntaras/tiktok-open-sdk
   changelog_uri: https://github.com/pochkuntaras/tiktok-open-sdk/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
+  documentation_uri: https://rubydoc.info/gems/tiktok-open-sdk
 rdoc_options: []
 require_paths:
 - lib

data/lib/tiktok/open/sdk/open_api/auth/helpers.rb

@@ -1,73 +0,0 @@
-# frozen_string_literal: true
-
-require 'json'
-
-module Tiktok
-  module Open
-    module Sdk
-      module OpenApi
-        module Auth
-          # Shared authentication helper methods for TikTok Open SDK auth modules.
-          module Helpers
-            include StringUtils
-
-            private
-
-            # Returns the HTTP headers for requests.
-            #
-            # @return [Hash] The headers for HTTP requests.
-            def headers
-              {
-                'Content-Type':  'application/x-www-form-urlencoded',
-                'Cache-Control': 'no-cache'
-              }
-            end
-
-            # Returns the client credentials for authentication.
-            #
-            # @return [Hash] The client credentials.
-            def credentials
-              {
-                client_key:    Tiktok::Open::Sdk.config.client_key,
-                client_secret: Tiktok::Open::Sdk.config.client_secret
-              }
-            end
-
-            # Returns the default query parameters for the authorization URI.
-            #
-            # @return [Hash] The default query parameters:
-            #   - :client_key [String] The TikTok client key.
-            #   - :response_type [String] Always 'code'.
-            #   - :scope [String] Comma-separated scopes.
-            #   - :redirect_uri [String] The redirect URI.
-            #   - :state [nil] Default state is nil.
-            def authorization_uri_default_params
-              {
-                client_key:    Tiktok::Open::Sdk.config.client_key,
-                response_type: 'code',
-                scope:         Tiktok::Open::Sdk.config.user_auth.scopes.join(','),
-                redirect_uri:  Tiktok::Open::Sdk.config.user_auth.redirect_uri,
-                state:         nil
-              }
-            end
-
-            # Parses and formats the HTTP response.
-            #
-            # @param response [Net::HTTPResponse] The HTTP response object.
-            # @return [Hash] The formatted response with keys:
-            #   - :success [Boolean] Whether the response is a Net::HTTPSuccess.
-            #   - :code [Integer] HTTP status code.
-            #   - :response [Hash] Parsed JSON body or a hash with the raw string if parsing fails.
-            def render_response(response)
-              {
-                success:  response.is_a?(Net::HTTPSuccess),
-                code:     response.code.to_i,
-                response: parse_json(response.body)
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/tiktok/open/sdk/string_utils.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require 'json'
-
-module Tiktok
-  module Open
-    module Sdk
-      # Utility methods for string and JSON handling.
-      module StringUtils
-        module_function
-
-        # Parses a JSON string into a Ruby hash with symbolized keys.
-        #
-        # @param str [String] JSON string to parse.
-        # @return [Hash] Parsed hash with symbolized keys, or a hash with the raw string if parsing fails.
-        def parse_json(str)
-          JSON.parse(str, symbolize_names: true)
-        rescue JSON::ParserError
-          { raw: str }
-        end
-      end
-    end
-  end
-end