Global Celular Gateway API Documentation

Send and receive text messages with just a few lines of code on Messaging, the trusted platform for cross-channel messaging.

Below are the endpoints for accessing Celular Gatewway. Learn how to integrate the API into your application.

Authorization:

  • privateId *Specify privateId for site
    (e.g., "Bearer example^com-SomeIdString").

Query Parameters:

  • type Specify type of SMS
    for Transactional OTP (e.g., type:"OTP").
    for Promotional Bulk (e.g., type:"TMP").
    for Informational personalized (e.g., type:"CXT").

Body Parameters:

  • CC Specify which rates to show
    (e.g., "US"|"IN"|"DE").
  • cellId Specify array of contact number
    (e.g., ["+91" + "99876543210"]).
  • :data Specify the mail OTP|TMP|CXT string
    for Transactional OTP (e.g., OTP:"000000").
    for Promotional Bulk (e.g., TMP:"sms-id-here").
    for Informational personalized (e.g., CXT:"sms-here").

Route Parameters:

  • :region *Please check location table here
    (e.g., "WEST_3|ARAB_1|EAST_3|NORD_6").

Response based on params:

{
  "success": true,
  "info": "SMS OTP Sent!"
}

POST

NoAuthLoyaltyEnterprise

This endpoint provides the text for sending celular sms.

require 'net/http'
require 'uri'
require 'json'

def fetch_data
  # API configuration
  base_url = 'https://textpress.api.koirang.com/v1/:region'
  params = {
    'region' => 'YOUR_REGION'  # Replace with actual region value
  }
  headers = {
    'Content-Type' => 'application/json',
    'Authorization' => "Bearer <privateId>"
  }
  query_params = {"mailId":"example@domain.com","OTP":"000000"}
  
  begin
    # Build URL
    url = base_url
    ["region"].each do |param|
      url += "/#{URI.encode_www_form_component(params[param])}"
    end
    
    # Add query parameters
    uri = URI(url)
    uri.query = URI.encode_www_form(query_params)
    
    # Create HTTP client
    http = Net::HTTP.new(uri.host, uri.port)
    http.use_ssl = uri.scheme == 'https'
    
    # Create request
    request = case 'GET'
             when 'POST'
               Net::HTTP::Post.new(uri)
             when 'PUT'
               Net::HTTP::Put.new(uri)
             when 'DELETE'
               Net::HTTP::Delete.new(uri)
             else
               Net::HTTP::Get.new(uri)
             end
    
    # Set headers
    headers.each { |key, value| request[key] = value }
    
    # Set body for POST/PUT requests
    if ['POST', 'PUT'].include?('GET')
      request.body = {"type":"OTP"}.to_json
    end
    
    # Send request
    response = http.request(request)
    
    # Check for errors
    unless response.is_a?(Net::HTTPSuccess)
      raise "HTTP error! status: #{response.code}"
    end
    
    JSON.parse(response.body)
  rescue StandardError => e
    puts "Error: #{e.message}"
    nil
  end
end

# Example usage
result = fetch_data
puts JSON.pretty_generate(result) if result