Telecom GPT

Telecom GPT · Ações GPT

TCXC SMS API

API for sending SMS messages via the TCXC Platform.

  • POST /send-smsSends an SMS message to specified destinations.
Esquema API original
{
  "openapi": "3.1.0",
  "info": {
    "title": "TCXC SMS API",
    "description": "API for sending SMS messages via the TCXC Platform.",
    "version": "1.0.2"
  },
  "servers": [
    {
      "url": "https://send-sms-ntx-api.replit.app",
      "description": "SMS Gateway API Server"
    }
  ],
  "paths": {
    "/send-sms": {
      "post": {
        "operationId": "sendSms",
        "summary": "Sends an SMS message to specified destinations.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "destinations",
                  "text",
                  "username",
                  "password"
                ],
                "properties": {
                  "destinations": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "The destination phone number(s) that the user wishes to reach. Provide each number in international format."
                  },
                  "text": {
                    "type": "string"
                  },
                  "username": {
                    "type": "string",
                    "description": "Username for SMPP account. This is required to send SMS. Obtain from members.telecomsxchange.com if you do not have one."
                  },
                  "password": {
                    "type": "string",
                    "description": "Password for SMPP account. This is required to send SMS. Obtain from members.telecomsxchange.com if you do not have one."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "SMS sent successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "API-transactionID": {
                      "type": "string"
                    },
                    "NTX MessageID": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "Sender ID": {
                      "type": "string"
                    },
                    "Destinations": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "Source_addr_NPI": {
                      "type": "integer"
                    },
                    "Source_addr_TON": {
                      "type": "integer"
                    },
                    "Destination_addr_NPI": {
                      "type": "integer"
                    },
                    "Destination_addr_TON": {
                      "type": "integer"
                    },
                    "Registered_Delivery": {
                      "type": "integer"
                    },
                    "time_stamp": {
                      "type": "string"
                    },
                    "Message Status": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "detail": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

TelecomsXChange MarketView API

API to proxy requests to TelecomsXChange Market View Search

  • POST /proxyProxies a request to TelecomsXChange Market View Search
Esquema API original
{
  "openapi": "3.1.0",
  "info": {
    "title": "TelecomsXChange MarketView API",
    "version": "1.0.0",
    "description": "API to proxy requests to TelecomsXChange Market View Search"
  },
  "servers": [
    {
      "url": "https://market-view-api-tcxc.replit.app"
    }
  ],
  "paths": {
    "/proxy": {
      "post": {
        "summary": "Proxies a request to TelecomsXChange Market View Search",
        "operationId": "priceLookup",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "prefix": {
                    "type": "string",
                    "description": "The prefix to search for"
                  },
                  "searchform": {
                    "type": "integer",
                    "default": 1,
                    "description": "Search form identifier"
                  },
                  "smpp": {
                    "type": "integer",
                    "default": 0,
                    "description": "Set to 1 to look up SMS routes; 0 for voice routes"
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "cli",
                      "nocli",
                      "tdm",
                      "any"
                    ],
                    "default": "any",
                    "description": "Route Type - cli, nocli, tdm, or any"
                  },
                  "seller": {
                    "type": "string",
                    "description": "Seller name"
                  },
                  "pager": {
                    "type": "integer",
                    "description": "Number of results per page"
                  },
                  "off": {
                    "type": "integer",
                    "description": "Offset for pagination"
                  }
                },
                "required": [
                  "prefix"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response with the search results",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "success"
                    },
                    "rates": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "prefix": {
                            "type": "string"
                          },
                          "vendor_name": {
                            "type": "string"
                          },
                          "connection_name": {
                            "type": "string"
                          },
                          "i_tariff": {
                            "type": "string"
                          },
                          "daily_asr": {
                            "type": "integer"
                          },
                          "weekly_asr": {
                            "type": "integer"
                          },
                          "daily_acd": {
                            "type": "integer"
                          },
                          "weekly_acd": {
                            "type": "integer"
                          },
                          "daily_minutes": {
                            "type": "integer"
                          },
                          "weekly_minutes": {
                            "type": "integer"
                          },
                          "stats_time": {
                            "type": "string"
                          },
                          "i_connection": {
                            "type": "string"
                          },
                          "effective_from": {
                            "type": "string"
                          },
                          "price_1": {
                            "type": "string"
                          },
                          "price_n": {
                            "type": "string"
                          },
                          "interval_1": {
                            "type": "string"
                          },
                          "interval_n": {
                            "type": "string"
                          },
                          "i_vendor": {
                            "type": "string"
                          },
                          "capacity_limit": {
                            "type": "string"
                          },
                          "i_rate": {
                            "type": "string"
                          },
                          "forbidden": {
                            "type": "string"
                          },
                          "discontinued": {
                            "type": "string"
                          },
                          "route_type": {
                            "type": "string"
                          },
                          "seller_registration_date": {
                            "type": "string"
                          },
                          "vendor_short_memo": {
                            "type": "string"
                          },
                          "connection_short_memo": {
                            "type": "string"
                          },
                          "anonymous": {
                            "type": "string"
                          },
                          "pos_on_page": {
                            "type": "integer"
                          },
                          "country_code": {
                            "type": "string"
                          },
                          "country_name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "mccmnc": {
                            "type": "string"
                          },
                          "seller_avg_rating": {
                            "type": "integer"
                          },
                          "seller_reviews": {
                            "type": "integer"
                          },
                          "orig_effective_from": {
                            "type": "string"
                          },
                          "rateid": {
                            "type": "integer"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Client error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          },
          "status_code": {
            "type": "integer"
          }
        }
      }
    }
  }
}

Destinations API

  • POST /search/Search in destinations

    Allows searching for destinations based on various criteria.

Esquema API original
{
  "openapi": "3.1.0",
  "info": {
    "title": "Destinations API",
    "version": "1.0.0"
  },
  "description": "API for searching destinations in the TelecomsXChange database.",
  "servers": [
    {
      "url": "https://destinations-api.telecomsxchange.com",
      "description": "Production server"
    }
  ],
  "paths": {
    "/search/": {
      "post": {
        "summary": "Search in destinations",
        "description": "Allows searching for destinations based on various criteria.",
        "operationId": "searchDestinations",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SearchParams"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Destination"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Validation Error"
          },
          "500": {
            "description": "Internal Server Error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "SearchParams": {
        "type": "object",
        "properties": {
          "prefix": {
            "type": "string",
            "description": "The prefix to search for.",
            "example": "4473971"
          },
          "country_name": {
            "type": "string",
            "description": "The name of the country.",
            "example": "UNITED KINGDOM"
          },
          "description": {
            "type": "string",
            "description": "Description of the destination.",
            "example": "Mobile - Airtel"
          },
          "mccmnc": {
            "type": "integer",
            "description": "The MCCMNC code.",
            "example": 23420
          }
        }
      },
      "Destination": {
        "type": "object",
        "properties": {
          "i_destination": {
            "type": "integer",
            "description": "Unique identifier for the destination."
          },
          "prefix": {
            "type": "string",
            "description": "The prefix associated with the destination."
          },
          "country_name": {
            "type": "string",
            "description": "Name of the country for the destination."
          },
          "description": {
            "type": "string",
            "description": "Description of the destination."
          },
          "mccmnc": {
            "type": "integer",
            "description": "MCCMNC code associated with the destination."
          },
          "interval_1": {
            "type": "integer",
            "description": "Interval 1 value."
          },
          "interval_n": {
            "type": "integer",
            "description": "Interval N value."
          }
        }
      }
    }
  }
}

TelecomsXChange API

This API provides an interface for HLR lookups and eSIM marketplace via the TelecomsXChange platform.

  • POST /hlr-lookupPerform an HLR lookup
  • POST /esim/marketSearch eSIM packages in the marketplace
Esquema API original
{
  "openapi": "3.1.0",
  "info": {
    "title": "TelecomsXChange API",
    "description": "This API provides an interface for HLR lookups and eSIM marketplace via the TelecomsXChange platform.\n",
    "version": "1.1.0"
  },
  "servers": [
    {
      "url": "https://telecomgpt.telecomsxchange.com",
      "description": "Local server for testing"
    }
  ],
  "paths": {
    "/hlr-lookup": {
      "post": {
        "operationId": "hlrLookup",
        "summary": "Perform an HLR lookup",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "phone_number"
                ],
                "properties": {
                  "phone_number": {
                    "type": "string",
                    "description": "The phone number to perform HLR lookup on."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful HLR lookup",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "description": "Overall status of the response."
                    },
                    "response": {
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "integer",
                          "description": "Status code of the HLR lookup."
                        },
                        "status_message": {
                          "type": "string",
                          "description": "Message detailing the status of the HLR lookup."
                        },
                        "request_id": {
                          "type": "string",
                          "description": "Unique identifier for the HLR lookup request."
                        },
                        "international_format_number": {
                          "type": "string",
                          "description": "Phone number in international format."
                        },
                        "national_format_number": {
                          "type": "string",
                          "description": "Phone number in national format."
                        },
                        "country_code": {
                          "type": "string",
                          "description": "Two-letter country code."
                        },
                        "country_code_iso3": {
                          "type": "string",
                          "description": "Three-letter country code ISO."
                        },
                        "country_name": {
                          "type": "string",
                          "description": "Full name of the country."
                        },
                        "country_prefix": {
                          "type": "string",
                          "description": "Telephone country prefix."
                        },
                        "current_carrier": {
                          "type": "object",
                          "properties": {
                            "network_code": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "country": {
                              "type": "string"
                            },
                            "network_type": {
                              "type": "string"
                            }
                          }
                        },
                        "original_carrier": {
                          "type": "object",
                          "properties": {
                            "network_code": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "country": {
                              "type": "string"
                            },
                            "network_type": {
                              "type": "string"
                            }
                          }
                        },
                        "ported": {
                          "type": "string",
                          "description": "Information about the ported status of the number."
                        },
                        "roaming": {
                          "type": "object",
                          "properties": {
                            "status": {
                              "type": "string",
                              "description": "Roaming status of the phone number."
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Client Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "detail": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "detail": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/esim/market": {
      "post": {
        "operationId": "esimMarket",
        "summary": "Search eSIM packages in the marketplace",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "country"
                ],
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Country name to search for eSIM packages (e.g., UKRAINE, GERMANY)"
                  },
                  "pager": {
                    "type": "integer",
                    "default": 10,
                    "description": "Number of results per page"
                  },
                  "offset": {
                    "type": "integer",
                    "default": 0,
                    "description": "Offset for pagination"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful eSIM market search",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "description": "Status of the response (success/error)"
                    },
                    "search_results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "i_esim_package": {
                            "type": "string",
                            "description": "Unique identifier for the eSIM package"
                          },
                          "i_vendor": {
                            "type": "string",
                            "description": "Vendor identifier"
                          },
                          "country_code": {
                            "type": "string",
                            "description": "Two-letter country code"
                          },
                          "name": {
                            "type": "string",
                            "description": "Package name"
                          },
                          "validity_days": {
                            "type": "string",
                            "description": "Number of days the package is valid"
                          },
                          "data_gb": {
                            "type": "string",
                            "description": "Data allowance in GB (-1 for unlimited)"
                          },
                          "networks": {
                            "type": "string",
                            "description": "Supported networks"
                          },
                          "vendor_login": {
                            "type": "string",
                            "description": "Vendor login name"
                          },
                          "price_with_fee": {
                            "type": "string",
                            "description": "Price including fees"
                          },
                          "supported_countries": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "country_name": {
                                  "type": "string"
                                },
                                "country_code": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Client Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "detail": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "detail": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}