openapi: '3.0.2'
info:
title: Signalmash API Platform
version: '1.0'
description: "Every API request authenticates the user, which you may do through the customer's site by creating tokens. Customers can now use the same or different tokens for each activity they make, thanks to a single management location.Log in to the portal, then go to the API Menu and select \"Tokens\" from the submenu.
To make a token, go to the right upper corner and click \"Add Token.\"
There will be a pop-up window. Choose the function (s) to link to the token."
servers:
# - url: http://localhost:4219
- url: https://signalmashdbtest.gventure.info/api
components:
securitySchemes:
Bearer:
type: apiKey
name: Authorization
in: header
tags:
- name: Login
description:
externalDocs:
url: http://docs.my-api.com/pet-operations.htm
paths:
# /apilogin:
# post:
# description:
The Login API is used to verify a user's API Username (Token Name) and API Key. The function outputs your validated session token which is used to authenticate all your Signalmash API calls.
# tags:
# - Login
# requestBody:
# required: true
# content:
# application/x-www-form-urlencoded:
# schema:
# type: object
# properties:
# Username:
# type: string
# description: Enter Your Token Name
# Password:
# type: string
# description: Enter Your Api Key
# required:
# - Username
# - Password
# responses:
# '200':
# description: Login Successfully
# /deleteAccount:
# put:
# summary: Delete My Account
# description: This Function Will Provide Ability To Disable Accounts and Endpoints/Connections
# tags:
# - Account
# security:
# - Bearer: []
# responses:
# '201':
# description: Account Detail Find Successfully.
/checkBalance:
get:
summary: Get Account Balance.
description: To Check balance
tags:
- Account
parameters:
- name: apiKey
in: query
description: Enter API Key
required: true
schema:
type: string
security:
- Bearer: []
responses:
'200':
description: Balance Fetched Successfully.
/webhookSubscription:
put:
summary: Subscribe API Webhook.
description: Subscribe to receive notifications of an "event category". Make sure your network policy allows HTTP POST to be accepted from internet.
tags:
- Webhook
security:
- Bearer: []
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
eventCategory:
type: boolean
enum: [A2P Campaign]
description: "Selete one option for perform"
webhookEndpoint:
type: string
description: "Enter webhookEndpointExample:http://www.webhook.php"
required:
- eventCategory
- webhookEndpoint
responses:
'201':
description: webhookEndpoint Added Successfully
/get_did:
get:
summary: Get all DIDs
description: This endpoint will return only the DID value for all DIDs
tags:
- Numbers
parameters:
- name: campaignKey
in: query
required: false
schema:
type: string
- name: NPA
in: query
required: false
schema:
format: int32
type: number
- name: NXX
in: query
required: false
schema:
format: int32
type: number
- name: rateCenter
in: query
required: false
schema:
type: string
- name: state
in: query
required: false
schema:
type: string
- name: start_date
in: query
description: Start Date in yyyy-MM-dd format
required: false
schema:
type: string
- name: end_date
in: query
description: End Date in yyyy-MM-dd format
required: false
schema:
type: string
- name: page
in: query
required: false
schema:
format: int32
type: number
minimum: 1
default: 1
- name: recordsPerPage
in: query
description: Maximum Limit (1 - 500)
required: false
schema:
format: int32
type: number
minimum: 1
maximum: 500
default: 500
security:
- Bearer: []
responses:
'200':
description: DIDs Fetched Successfully.
/get_did_details:
get:
summary: Get DID's Detail
description: This endpoint should ask for the parameter 'DID' and return full details for this single DID requested
tags:
- Numbers
parameters:
- name: DID
in: query
description: You can search NN,TF and Short-code number here.
required: true
schema:
type: number
security:
- Bearer: []
responses:
'200':
description: Record Fetched Successfully.
/get_did_all:
get:
summary: Get all DIDs with Details
description: This endpoint will return FULL output values for all DIDs
tags:
- Numbers
parameters:
- name: campaignKey
in: query
description: Enter campaignKey.
required: false
schema:
type: string
- name: connectionKey
in: query
description: Enter connectionKey.
required: false
schema:
type: string
security:
- Bearer: []
responses:
'200':
description: DIDs Fetched Successfully.
/getstate:
get:
description: This function is provided to assist in developing phone number search applications.This function outputs the list of all two letter state, province and region abbreviations in the North American Numbering Plan.
tags:
- Numbers
security:
- Bearer: []
responses:
'200':
description: State Find Successfully.
/getratecenter:
get:
description: This function is provided to assist in developing phone number search applications.This function outputs the list of all Rate Centers abbreviations in a state. Rate Center abbreviations are related to cities but in larger cities will often be more specific.
tags:
- Numbers
parameters:
- name: State
in: query
description: The two letter state abbreviation. Example:NJ
required: true
schema:
type: string
security:
- Bearer: []
responses:
'200':
description: Rate Center Find Successfully.
/getnpa:
get:
description: This function is provided to assist in developing phone number search applications.This function outputs the list of all NPAs in a state. NPA is commonly referred to as an Area Code, the first three digits of a North American Numbering Plan phone number.
tags:
- Numbers
parameters:
- name: State
in: query
description: The two letter state abbreviation. Example:NJ
required: true
schema:
type: string
security:
- Bearer: []
responses:
'200':
description: NPA Find Successfully.
/getnxx:
get:
description: This function is provided to assist in developing phone number search applications.This function outputs the list of all NXXs in an NPA. NXX is commonly referred to as a prefix or exchange, the second three digits of a North American Numbering Plan phone number.
tags:
- Numbers
parameters:
- name: NPA
in: query
description: Commonly referred to as an Area Code, the first three digits of a North American Numbering Plan phone numberExample:201
required: true
schema:
type: string
security:
- Bearer: []
responses:
'200':
description: NXX Find Successfully.
/searchbynpa:
get:
description: This function allows for real-time searching of phone numbers available to be purchased.With this search option NPA (Area Code) and the desired phone number Quantity (Qty) being minimally specified, with NXX (Prefix) being allowed as an optional search parameter.This function outputs a list of phone numbers available to be purchased matching the submitted search criteria.
tags:
- Numbers
parameters:
- name: NPA
in: query
description: Commonly referred to as an Area Code, the first three digits of a North American Numbering Plan phone numberExample:201
required: true
schema:
type: string
- name: NXX
in: query
description: The second three digits of a North American Numbering Plan phone number, commonly referred to as a prefix or exchangeExample:200
schema:
type: string
- name: Qty
in: query
description: Enter the quantity of phone numbers requested as an integer numberExample:1
required: true
schema:
type: integer
# - name: CampaignId
# in: query
# description: Enter a text characterExample:1
# schema:
# type: string
security:
- Bearer: []
responses:
'200':
description: DID Find Successfully.
/searchbyrate:
get:
description: This function allows for real-time searching of phone numbers available to be purchased.With this search option Rate Center abbreviation (RateCenter), the two letter State abbreviation (State) and the desired phone number Quantity (Qty) are required search parameters.This function outputs a list of phone numbers available to be purchased matching the submitted search criteria.
tags:
- Numbers
parameters:
- name: RateCenter
in: query
description: The Rate Center abbreviation (available via getratecenter API), which is a geographical Rate Exchange Area.Example:JERSEYCITY
required: true
schema:
type: string
- name: State
in: query
description: The two letter state abbreviation. Example:NJ
required: true
schema:
type: string
- name: Qty
in: query
description: Enter the quantity of phone numbers requested as an integer numberExample:1
required: true
schema:
type: integer
# - name: CampaignId
# in: query
# description: Enter a text characterExample:1
# schema:
# type: string
security:
- Bearer: []
responses:
'200':
description: DID Find Successfully
/BuyTollfree:
post:
description: This function allows for Buy toll free phone numbers. Quantity (Qty) are required search parameters.
tags:
- Numbers
parameters:
- name: Quantity
in: query
description: Enter the quantity of toll free phone numbers requested as an integer numberExample:1
required: true
schema:
type: integer
security:
- Bearer: []
responses:
'200':
description: Tollfree Number Buy Successfully.
/buy:
post:
description: This function allows for the real-time purchase of available local and toll free phone numbers.Optionally, if you have already configured a set of Connection parameters you can apply these to the number when purchased.If you would like the number to use all parameters from a Connection you may choose the Connection ID value and all connection values will be used.You may also choose to override just the Inbound or Outbound Connection settings for a phone number.
tags:
- Numbers
security:
- Bearer: []
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
DID:
type: string
description: "The ten digit phone number. Example:8632146398"
Connection:
type: string
description: "The primary Connection ID key from your Connection.Example:Cd9_iamCm7UUGPxpZtBEk574e6_5xC"
InboundSMS:
type: string
OutboundSMS:
type: string
InboundVoice:
type: string
description: "The INBOUND ID key from your Connection.Example:d-no90P36tJljlp9shYt7oT0nKlIQo"
OutboundVoice:
type: string
description: "The OUTBOUND ID key from your Connection.Example:vHveiRH3rV8qF40zbOTZnByW9GWNRz"
required:
- DID
responses:
'201':
description: DID Number Purchase Successfully
/enablesms:
post:
description: This function allows you to provision A2P text messaging (SMS/MMS) services on a local phone number.You must first complete your A2P Brand and Campaign registration process before you can enable messaging service.
tags:
- Numbers
security:
- Bearer: []
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
DID:
type: string
description: "The ten digit phone number.Example:8632146398"
CampaignId:
type: string
description: "The Campaign ID value from your registered A2P campaign.Example:CWXYZAS"
required:
- DID
- CampaignId
responses:
'201':
description: Enable SMS Successfully
/importNumber:
post:
summary: Import External Numbers.
description: This function allows you to Import External Numbers.
tags:
- Numbers
security:
- Bearer: []
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
DID:
type: string
minLength: 10
maxLength: 10
description: "The ten digit phone number.Example:8632146398"
required:
- DID
responses:
'201':
description: Number is Imported Successfully
/disablesms:
delete:
description: This function allows you to remove A2P text messaging (SMS/MMS) services from a phone number.
tags:
- Numbers
parameters:
- name: DID
in: query
description: "The ten digit phone number. Example:8632146398"
required: true
schema:
type: string
security:
- Bearer: []
responses:
'200':
description: Disable Offnet Successfully.
#/enablesmsstatus:
# get:
# description: This function allows you to check the registry status of A2P text messaging (SMS/MMS) services on a phone number.
# tags:
# - Numbers
# parameters:
# - name: DID
# in: query
# description: "The ten digit phone number.Example:8632146398"
# required: true
# schema:
# type: string
# security:
# - Bearer: []
# responses:
# '200':
# description: Offnet status Find Successfully.
#/enablesmsnotifications:
# get:
# description: To find the notifications using this API
# tags:
# - Numbers
# parameters:
# - name: TID
# in: query
# description: "It is a transaction id as integer number.First time put 0 and next time put higher value of 0 liks as 105Example:0"
# required: true
# schema:
# type: string
# security:
# - Bearer: []
# responses:
# '200':
# description: Offnet status Find Successfully.
/disconnect:
post:
description: "This function allows you to remove a phone number from your account.NOTE : This command cannot be undone. All services will be removed from the phone number and the number will be released from your account and may not be able to be retrieved."
tags:
- Numbers
security:
- Bearer: []
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
DID: #