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!"
}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