tiktok-open-sdk 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 804836be4e23b6a46c29c263b7b6d802cd2e6a70c61ed02a8f70328715649236
-  data.tar.gz: d2dee367fb303f07078a5e07a5a303f163db4895bb3e7468bbdeb2678308e1db
+  metadata.gz: ea350ded46bc468a3b86a72f539c12a36ecc960b1e2476ac7e59c2c52424d8f1
+  data.tar.gz: 07fa578800d4d03d9431c39b043008d2185ed62ed2f93c8c20feea8bb331736d
 SHA512:
-  metadata.gz: 860dfd7da6a964785d661f1e6c9b2fd84bb324f1c8511207c0b3f981239b5d361490b8c410f31d0600bd5b4302c21b3b0cc69e370ad80814c1dc24c05b03ab06
-  data.tar.gz: 7707f1602f9c088c7d84aff5c20101138fd30e9bfb91569f13062c7e56591361fe4b1ecff06ee6b26b82ee89f362ffb2b5244fb4823c7989b8d9c125df9f9bd2
+  metadata.gz: 61e3742ea46ddeb02a8a168d3485c7ecc7632698c6c533364e392b67058f6a5d7e325e0e546eebe9eee915070e309981dc8707aca7ff67097dfadd74610977d0
+  data.tar.gz: f19aa49f93036f0b02f0d5613d76b7bd86e7a00457a3642569c3f266ac895720a4106e7df27fec6f215581ccfd6fcedb71ac68638c83fdddcfc0dca8b56d5052

data/.rubocop.yml

@@ -30,7 +30,7 @@ Style/ModuleFunction:
   Enabled: false
 
 RSpec/NestedGroups:
-  Max: 4
+  Max: 5
 
 RSpec/MultipleExpectations:
   Max: 5

data/CHANGELOG.md

@@ -4,7 +4,9 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.5.0] - 2026-02-14
+### Added
+- **Post API: video_init** - Initialize a video publish to obtain an upload URL (file upload) or to start a pull-from-URL flow. Accepts `access_token` and `params` (post_info, source_info). Optional config: `video_init_url`.
 
 ## [0.4.0] - 2025-10-06
 ### Added

data/README.md

@@ -1,6 +1,6 @@
 # TikTok Open SDK
 
-[![Gem Version](https://img.shields.io/badge/gem-v0.4.0-blue.svg)](https://rubygems.org/gems/tiktok-open-sdk)
+[![Gem Version](https://img.shields.io/badge/gem-v0.5.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)
@@ -59,6 +59,7 @@ Tiktok::Open::Sdk.configure do |config|
   config.user_auth.revoke_token_url = 'https://open.tiktokapis.com/v2/oauth/revoke/'
   config.user_info_url              = 'https://open.tiktokapis.com/v2/user/info/'
   config.creator_info_query_url     = 'https://open.tiktokapis.com/v2/post/publish/creator_info/query/'
+  config.video_init_url             = 'https://open.tiktokapis.com/v2/post/publish/video/init/'
 
   # Optional: Enable OmniAuth strategy auto-loading
   config.load_omniauth = true
@@ -188,6 +189,40 @@ else
 end
 ```
 
+#### Video Init
+
+Initialize a video publish to obtain an upload URL (for file upload) or to start a pull-from-URL flow:
+
+```ruby
+params = {
+  post_info: {
+    title:                    'My video #tiktok',
+    privacy_level:            'SELF_ONLY',
+    disable_duet:             false,
+    disable_comment:          false,
+    disable_stitch:           false,
+    video_cover_timestamp_ms: 1000
+  },
+  source_info: {
+    source:            'FILE_UPLOAD',
+    video_type:        'video/mp4',
+    video_size:        7_340_032,
+    chunk_size:        7_340_032,
+    total_chunk_count: 1
+  }
+}
+
+response = Tiktok::Open::Sdk.post.video_init(access_token: access_token, params: params)
+
+if response[:success]
+  publish_id = response[:response][:data][:publish_id]
+  upload_url = response[:response][:data][:upload_url]
+  # Use upload_url to upload video chunks (FILE_UPLOAD) or proceed with PULL_FROM_URL flow
+else
+  puts "Error: #{response[:response][:error][:message]}"
+end
+```
+
 ### Using the User API
 
 The SDK provides a convenient way to access user information:
@@ -428,6 +463,8 @@ Tiktok::Open::Sdk.configure do |config|
   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
+  config.creator_info_query_url = 'https://open.tiktokapis.com/v2/post/publish/creator_info/query/' # Optional
+  config.video_init_url         = 'https://open.tiktokapis.com/v2/post/publish/video/init/' # Optional
 end
 ```
 
@@ -543,6 +580,24 @@ Queries creator information from the TikTok Open API for video publishing.
 - `max_video_post_duration_sec` - Maximum video duration in seconds
 - `privacy_level_options` - Available privacy level options
 
+#### `video_init(access_token:, params: {})`
+
+Initializes a video publish and returns a publish ID and upload URL (for file upload) or starts a pull-from-URL flow.
+
+**Parameters:**
+- `access_token` (String, required) - OAuth2 access token for authentication
+- `params` (Hash, required) - Request body with `post_info` and `source_info`
+  - `post_info` - Post metadata (title, privacy_level, disable_duet, disable_comment, disable_stitch, video_cover_timestamp_ms, etc.)
+  - `source_info` - Video source (e.g. `source: 'FILE_UPLOAD'` with video_size, chunk_size, total_chunk_count, video_type; or `source: 'PULL_FROM_URL'` with video_url)
+
+**Returns:** Hash with `:success`, `:code`, and `:response` keys
+
+**Response Data (on success):**
+- `data.publish_id` - Publish session ID
+- `data.upload_url` - URL for uploading video chunks (when using FILE_UPLOAD)
+
+**Raises:** `Tiktok::Open::Sdk::RequestValidationError` if access token is invalid or params fail validation
+
 ### HTTP Client
 
 #### `request(method, url, params: {}, headers: {}, body: nil)`

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

@@ -33,6 +33,10 @@ module Tiktok
         #   @return [String] TikTok Query Creator Info endpoint URL.
         attr_accessor :creator_info_query_url
 
+        # @!attribute [rw] video_init_url
+        #   @return [String] TikTok Video Init endpoint URL.
+        attr_accessor :video_init_url
+
         # @!attribute [rw] user_auth
         #   @return [UserAuth] User authentication configuration.
         attr_accessor :user_auth
@@ -45,6 +49,7 @@ module Tiktok
         def initialize
           @user_info_url          = "#{OPEN_API_BASE_URL}/v2/user/info/"
           @creator_info_query_url = "#{OPEN_API_BASE_URL}/v2/post/publish/creator_info/query/"
+          @video_init_url         = "#{OPEN_API_BASE_URL}/v2/post/publish/video/init/"
           @user_auth              = UserAuth.new
           @load_omniauth          = false
         end

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

@@ -0,0 +1,178 @@
+# frozen_string_literal: true
+
+module Tiktok
+  module Open
+    module Sdk
+      module Helpers
+        module Validators
+          # Validates post information for TikTok video publishing.
+          #
+          # This module provides validation methods for post-related parameters including
+          # privacy level, title, boolean flags, and video cover timestamp.
+          #
+          # @example Including the validator in a class
+          #   class VideoPublisher
+          #     include Tiktok::Open::Sdk::Helpers::Validators::PostInfoValidator
+          #
+          #     def publish(post_info)
+          #       validate_post_info!(post_info)
+          #       # proceed with publishing
+          #     end
+          #   end
+          #
+          # @example Validating post information
+          #   post_info = {
+          #     privacy_level: 'PUBLIC_TO_EVERYONE',
+          #     title: 'My awesome video',
+          #     disable_duet: false,
+          #     brand_content_toggle: true
+          #   }
+          #   validate_post_info!(post_info)
+          module PostInfoValidator
+            # Valid privacy level options for TikTok videos
+            PRIVACY_LEVEL_OPTIONS = %w[
+              PUBLIC_TO_EVERYONE
+              MUTUAL_FOLLOW_FRIENDS
+              FOLLOWER_OF_CREATOR
+              SELF_ONLY
+            ].freeze
+
+            # Maximum allowed length for video title
+            MAX_TITLE_LENGTH = 2200
+
+            # Validates post information and raises an error if invalid.
+            #
+            # @param post_info [Hash, nil] The post information to validate
+            # @option post_info [String] :privacy_level Required. Must be one of PRIVACY_LEVEL_OPTIONS
+            # @option post_info [String] :title Optional. Maximum 2200 characters
+            # @option post_info [Boolean] :disable_duet Optional. Boolean flag
+            # @option post_info [Boolean] :disable_stitch Optional. Boolean flag
+            # @option post_info [Boolean] :disable_comment Optional. Boolean flag
+            # @option post_info [Boolean] :brand_content_toggle Optional. Boolean flag
+            # @option post_info [Boolean] :brand_organic_toggle Optional. Boolean flag
+            # @option post_info [Boolean] :is_aigc Optional. Boolean flag
+            # @option post_info [Integer] :video_cover_timestamp_ms Optional. Non-negative integer
+            #
+            # @return [void]
+            # @raise [Tiktok::Open::Sdk::RequestValidationError] If validation fails
+            #
+            # @example Valid post information
+            #   validate_post_info!(privacy_level: 'PUBLIC_TO_EVERYONE')
+            #
+            # @example Invalid privacy level
+            #   validate_post_info!(privacy_level: 'INVALID')
+            #   # => raises RequestValidationError with privacy_level error
+            def validate_post_info!(post_info)
+              errors = {}
+
+              validate_post_info(post_info, errors)
+
+              raise_validation_errors!(errors)
+            end
+
+            private
+
+            # Raises validation errors if any exist.
+            #
+            # @param errors [Hash] The accumulated validation errors
+            # @return [void]
+            # @raise [Tiktok::Open::Sdk::RequestValidationError] If errors is not empty
+            def raise_validation_errors!(errors)
+              raise ::Tiktok::Open::Sdk::RequestValidationError, errors unless errors.empty?
+            end
+
+            # Validates post information and accumulates errors.
+            #
+            # @param post_info [Hash, nil] The post information to validate
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_post_info(post_info, errors)
+              return if post_info.nil?
+              return add_error errors, :post_info, 'must be a Hash' unless post_info.is_a?(Hash)
+
+              privacy_level = post_info[:privacy_level]
+              title         = post_info[:title]
+              timestamp     = post_info[:video_cover_timestamp_ms]
+
+              validate_privacy_level!         privacy_level, errors
+              validate_title!                 title,         errors
+              validate_boolean_fields!        post_info,     errors
+              validate_video_cover_timestamp! timestamp,     errors
+            end
+
+            # Validates that privacy level is one of the allowed options.
+            #
+            # @param privacy_level [String, nil] The privacy level to validate
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_privacy_level!(privacy_level, errors)
+              return if PRIVACY_LEVEL_OPTIONS.include?(privacy_level)
+
+              add_error errors, :privacy_level, "must be one of: #{PRIVACY_LEVEL_OPTIONS.join(", ")}"
+            end
+
+            # Validates video title length and type.
+            #
+            # @param title [String, nil] The title to validate
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_title!(title, errors)
+              return if title.nil?
+              return add_error errors, :title, 'must be a String' unless title.is_a?(String)
+              return unless title.length > MAX_TITLE_LENGTH
+
+              add_error errors, :title, "must be less than #{MAX_TITLE_LENGTH} characters"
+            end
+
+            # Validates that boolean fields contain boolean values.
+            #
+            # @param post_info [Hash] The post information containing boolean fields
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_boolean_fields!(post_info, errors)
+              boolean_fields = %i[
+                disable_duet
+                disable_stitch
+                disable_comment
+                brand_content_toggle
+                brand_organic_toggle
+                is_aigc
+              ]
+
+              boolean_fields.each do |field|
+                next unless post_info.key?(field)
+
+                value = post_info[field]
+                next if value.is_a?(TrueClass) || value.is_a?(FalseClass)
+
+                add_error errors, field, 'must be a boolean (true or false)'
+              end
+            end
+
+            # Validates video cover timestamp is a non-negative integer.
+            #
+            # @param timestamp [Integer, nil] The timestamp to validate
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_video_cover_timestamp!(timestamp, errors)
+              return if timestamp.nil? || (timestamp.is_a?(Integer) && timestamp >= 0)
+
+              add_error errors, :video_cover_timestamp_ms, 'must be a non-negative integer'
+            end
+
+            # Adds an error message to the errors hash.
+            #
+            # @param errors [Hash] The hash to accumulate errors into
+            # @param field_name [Symbol] The field name that has an error
+            # @param message [String] The error message
+            # @return [Hash] The errors hash
+            def add_error(errors, field_name, message)
+              errors[field_name] ||= [] << message
+              errors
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require_relative 'post_info_validator'
+require_relative 'source_info_validator'
+
+module Tiktok
+  module Open
+    module Sdk
+      module Helpers
+        module Validators
+          # Provides validation for video publishing initialization parameters.
+          #
+          # This module combines and applies the `PostInfoValidator` and `SourceInfoValidator` logic
+          # for validating `post_info` and `source_info` input hashes typically required for
+          # TikTok Open SDK video publishing workflows.
+          #
+          # @example Including and using PostPublishValidator
+          #   class Publisher
+          #     include Tiktok::Open::Sdk::Helpers::Validators::PostPublishValidator
+          #
+          #     def publish_video(params)
+          #       validate_video_init_info!(params)
+          #       # ...proceed if valid
+          #     end
+          #   end
+          #
+          # @see PostInfoValidator#validate_post_info
+          # @see SourceInfoValidator#validate_source_info
+          module PostPublishValidator
+            include PostInfoValidator
+            include SourceInfoValidator
+
+            # Validates combined video initialization parameters.
+            #
+            # Both `post_info` and `source_info` sub-hashes are validated using the appropriate
+            # validators. If any errors occur, a RequestValidationError (or similar) is raised.
+            #
+            # @param params [Hash] The full parameter hash.
+            # @option params [Hash] :post_info Info for video post, validated by PostInfoValidator
+            # @option params [Hash] :source_info Info on video source, validated by SourceInfoValidator
+            #
+            # @raise [RequestValidationError] Raised if any validation errors found in either section.
+            # @return [void]
+            def validate_video_init_info!(params)
+              errors = { post_info: {}, source_info: {} }
+
+              validate_post_info   params[:post_info],   errors[:post_info]
+              validate_source_info params[:source_info], errors[:source_info]
+
+              raise_validation_errors!(errors) unless errors.values.all?(&:empty?)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,186 @@
+# frozen_string_literal: true
+
+module Tiktok
+  module Open
+    module Sdk
+      module Helpers
+        module Validators
+          # Validates source information for TikTok video publishing.
+          #
+          # This module provides validation methods for video source parameters including
+          # source type (PULL_FROM_URL or FILE_UPLOAD) and their respective required fields.
+          #
+          # @example Including the validator in a class
+          #   class VideoPublisher
+          #     include Tiktok::Open::Sdk::Helpers::Validators::SourceInfoValidator
+          #
+          #     def publish(source_info)
+          #       validate_source_info!(source_info)
+          #       # proceed with publishing
+          #     end
+          #   end
+          #
+          # @example Validating PULL_FROM_URL source
+          #   source_info = {
+          #     source: 'PULL_FROM_URL',
+          #     video_url: 'https://example.com/video.mp4'
+          #   }
+          #   validate_source_info!(source_info)
+          #
+          # @example Validating FILE_UPLOAD source
+          #   source_info = {
+          #     source: 'FILE_UPLOAD',
+          #     video_size: 10_485_760,
+          #     chunk_size: 1_048_576,
+          #     total_chunk_count: 10
+          #   }
+          #   validate_source_info!(source_info)
+          module SourceInfoValidator
+            # Valid source options for video uploads
+            SOURCE_OPTIONS = %w[
+              PULL_FROM_URL
+              FILE_UPLOAD
+            ].freeze
+
+            # Validates source information and raises an error if invalid.
+            #
+            # @param source_info [Hash, nil] The source information to validate
+            # @option source_info [String] :source Required. Must be 'PULL_FROM_URL' or 'FILE_UPLOAD'
+            # @option source_info [String] :video_url Required for PULL_FROM_URL. Non-empty video URL
+            # @option source_info [Integer] :video_size Required for FILE_UPLOAD. Positive integer
+            # @option source_info [Integer] :chunk_size Optional for FILE_UPLOAD. Positive integer
+            # @option source_info [Integer] :total_chunk_count Optional for FILE_UPLOAD. Positive integer
+            #
+            # @return [void]
+            # @raise [Tiktok::Open::Sdk::RequestValidationError] If validation fails
+            #
+            # @example Valid PULL_FROM_URL source
+            #   validate_source_info!(source: 'PULL_FROM_URL', video_url: 'https://example.com/video.mp4')
+            #
+            # @example Valid FILE_UPLOAD source
+            #   validate_source_info!(source: 'FILE_UPLOAD', video_size: 10_485_760)
+            #
+            # @example Invalid source type
+            #   validate_source_info!(source: 'INVALID')
+            #   # => raises RequestValidationError with source error
+            def validate_source_info!(source_info)
+              errors = {}
+
+              validate_source_info(source_info, errors)
+
+              raise_validation_errors!(errors)
+            end
+
+            private
+
+            # Raises validation errors if any exist.
+            #
+            # @param errors [Hash] The accumulated validation errors
+            # @return [void]
+            # @raise [Tiktok::Open::Sdk::RequestValidationError] If errors is not empty
+            def raise_validation_errors!(errors)
+              raise ::Tiktok::Open::Sdk::RequestValidationError, errors unless errors.empty?
+            end
+
+            # Validates source information and accumulates errors.
+            #
+            # @param source_info [Hash, nil] The source information to validate
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_source_info(source_info, errors)
+              if source_info.is_a?(Hash)
+                validate_source_specific_fields!(source_info, errors)
+              else
+                add_error errors, :source_info, 'must be a Hash'
+              end
+            end
+
+            # Validates source-specific required fields based on source type.
+            #
+            # @param source_info [Hash] The source information containing type-specific fields
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_source_specific_fields!(source_info, errors)
+              case source_info[:source]
+              when 'PULL_FROM_URL'
+                validate_pull_from_url_fields!(source_info, errors)
+              when 'FILE_UPLOAD'
+                validate_file_upload_fields!(source_info, errors)
+              else
+                add_error errors, :source, "must be one of: #{SOURCE_OPTIONS.join(", ")}"
+              end
+            end
+
+            # Validates required fields for PULL_FROM_URL source type.
+            #
+            # @param source_info [Hash] The source information
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_pull_from_url_fields!(source_info, errors)
+              video_url = source_info[:video_url]
+
+              return if video_url.is_a?(String) && !video_url.empty?
+
+              add_error errors, :video_url, 'is required and must be a non-empty string for PULL_FROM_URL'
+            end
+
+            # Validates required fields for FILE_UPLOAD source type.
+            #
+            # @param source_info [Hash] The source information
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_file_upload_fields!(source_info, errors)
+              validate_video_size!        source_info[:video_size],        errors
+              validate_chunk_size!        source_info[:chunk_size],        errors
+              validate_total_chunk_count! source_info[:total_chunk_count], errors
+            end
+
+            # Validates video size for FILE_UPLOAD source.
+            #
+            # @param video_size [Integer, nil] The video size in bytes
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_video_size!(video_size, errors)
+              return if video_size.is_a?(Integer) && video_size.positive?
+
+              add_error errors, :video_size, 'is required and must be a positive integer for FILE_UPLOAD'
+            end
+
+            # Validates chunk size for FILE_UPLOAD source.
+            #
+            # @param value [Integer, nil] The chunk size in bytes
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_chunk_size!(value, errors)
+              return if value.nil? || (value.is_a?(Integer) && value.positive?)
+
+              add_error errors, :chunk_size, 'must be a positive integer if provided'
+            end
+
+            # Validates total chunk count for FILE_UPLOAD source.
+            #
+            # @param value [Integer, nil] The total number of chunks
+            # @param errors [Hash] The hash to accumulate errors into
+            # @return [void]
+            def validate_total_chunk_count!(value, errors)
+              return if value.nil? || (value.is_a?(Integer) && value.positive?)
+
+              add_error errors, :total_chunk_count, 'must be a positive integer if provided'
+            end
+
+            # Adds an error message to the errors hash.
+            #
+            # @param errors [Hash] The hash to accumulate errors into
+            # @param field_name [Symbol] The field name that has an error
+            # @param message [String] The error message
+            # @return [Hash] The errors hash
+            def add_error(errors, field_name, message)
+              errors[field_name] ||= [] << message
+              errors
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -102,10 +102,11 @@ module Tiktok
         # @param body [Hash, nil] The request body.
         # @return [Net::HTTPRequest] The HTTP request object.
         def build_http_request(method, uri, headers, body)
-          klass   = Net::HTTP.const_get(method.capitalize)
-          request = klass.new(uri, headers)
+          klass        = Net::HTTP.const_get(method.capitalize)
+          request      = klass.new(uri, headers)
+          content_type = headers[:'Content-Type'] || headers['Content-Type']
 
-          body ? assign_body!(request, body, headers[:'Content-Type']) : request
+          body ? assign_body!(request, body, content_type) : request
         end
       end
     end

data/lib/tiktok/open/sdk/open_api/post/publish.rb

@@ -12,6 +12,7 @@ module Tiktok
 
             include ::Tiktok::Open::Sdk::Helpers::ResponseHelper
             include ::Tiktok::Open::Sdk::Helpers::Validators::TokenValidator
+            include ::Tiktok::Open::Sdk::Helpers::Validators::PostPublishValidator
 
             # Queries creator information from the TikTok Open API.
             #
@@ -31,6 +32,20 @@ module Tiktok
                 }
               )
             end
+
+            def video_init(access_token:, params: {})
+              validate_token!(access_token)
+              validate_video_init_info!(params)
+
+              render_response Tiktok::Open::Sdk::HttpClient.post(
+                Tiktok::Open::Sdk.config.video_init_url,
+                headers: {
+                  Authorization:  "Bearer #{access_token}",
+                  'Content-Type': 'application/json; charset=UTF-8'
+                },
+                body:    params
+              )
+            end
           end
         end
       end

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

@@ -3,7 +3,7 @@
 module Tiktok
   module Open
     module Sdk
-      VERSION = '0.4.0'
+      VERSION = '0.5.0'
     end
   end
 end

data/lib/tiktok/open/sdk.rb

@@ -4,6 +4,7 @@ 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/helpers/validators/post_publish_validator'
 require_relative 'sdk/open_api/auth/user'
 require_relative 'sdk/open_api/auth/client'
 require_relative 'sdk/open_api/post/publish'
@@ -22,7 +23,31 @@ module Tiktok
       #   raise Tiktok::Open::Sdk::Error, "Something went wrong"
       class Error < StandardError; end
 
-      class RequestValidationError < Error; end
+      # Error class for request validation failures
+      #
+      # This error is raised when request validation fails, providing access to
+      # detailed validation error information.
+      #
+      # @attr_reader messages [Hash, nil] validation errors hash or nil if no specific errors
+      #
+      # @example
+      #   raise RequestValidationError.new({ field: ['error message'] })
+      #   raise RequestValidationError.new('General validation error')
+      class RequestValidationError < Error
+        attr_reader :messages
+
+        def initialize(messages = nil)
+          if messages.is_a?(Hash)
+            @messages = messages
+
+            super('Validation failed')
+          else
+            @messages = nil
+
+            super
+          end
+        end
+      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.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Taras Pochkun
@@ -32,6 +32,9 @@ files:
 - 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/post_info_validator.rb
+- lib/tiktok/open/sdk/helpers/validators/post_publish_validator.rb
+- lib/tiktok/open/sdk/helpers/validators/source_info_validator.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