Home
MATRIXX Business API SDK
Business API Gateway
The Business API Gateway is a development framework that includes the Business API SDK, Rest Services Gateway (RS Gateway), Gateway Proxy, and application tier. It allows custom mobile applications, web clients, and other custom implementations to integrate with MATRIXX.
REST Services (RS) Gateway
RS Gateway provides an easy integration point for external REST clients and Java applications to make API calls to MATRIXX Engine.
RS Gateway Error Codes
Project extension developers can define error codes for each extension.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
- About MATRIXX Business API SDK
  MATRIXX Business API SDK provides the APIs, libraries, and other files needed to create a customized version of the RS Gateway.
- Business API SDK Overview
  The Business API SDK is a flexible framework that includes a set of tools to manage, customize and extend Rest Services Gateway (RS Gateway) for customer-specific business needs. Using the SDK, you can extend existing projects or create entirely new projects to add, replace, or modify services that leverage existing functionality.
- Business API Gateway
  The Business API Gateway is a development framework that includes the Business API SDK, Rest Services Gateway (RS Gateway), Gateway Proxy, and application tier. It allows custom mobile applications, web clients, and other custom implementations to integrate with MATRIXX.
  - REST Services (RS) Gateway
    RS Gateway provides an easy integration point for external REST clients and Java applications to make API calls to MATRIXX Engine.
    - User Authentication and Password Management
      Use the /service/user service APIs to set, verify, and modify a user password.
    - RS Gateway-Initiated Rating
      RS Gateway-initiated rating allows clients that do not support the Diameter protocol to use the MATRIXX charging, rating, and pricing functionality.
    - RS Gateway Error Codes
      Project extension developers can define error codes for each extension.
    - Understanding the REST Interface
      This section includes helpful information about the MATRIXX REST interface. For more information about REST and the SubMan REST APIs, see MATRIXX Subscriber Management API.
    - Making Multiple Requests in One API Call
      You can perform multiple engine requests (MtxRequestMulti) using a POST call to the RS Gateway. For example, one request can create a subscriber, create a device, and associate the device with that subscriber.
  - MDC Gateway
    The MDC Gateway conducts the internal exchange of data between MATRIXX servers and external exchange of subscriber management data with other MATRIXX gateways and web apps.
  - Business API Gateway APIs
    The Business API Gateway APIs manage devices, subscribers, and groups. These services provide detailed information about subscriber and group members, and administrators.
- Creating Extensions
  You create extensions using a Maven archetype and then add those extensions to the RS Gateway as JAR files.
- Creating Custom Filters
  You can create a custom filter by creating a named filter or a filter class. A named filter is useful for simple filters while a filter class should be used for complex filters (for example, when the returned results must be modified).
- Upgrading the Business API SDK
  When you upgrade the MATRIXX software, you must upgrade the Business API SDK as it is possible that files have changed or have been deprecated. Use the manage_integration_project.py script to remove the current release from your project directory structure and upgrade to the latest release. You should do this even if your files are not checked into Subversion.
- Appendixes
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

RS Gateway Error Codes

Project extension developers can define error codes for each extension.

Start error codes for each extension with numbers at the beginning of the range described here. Error numbers from project extension A's features are independent of the error numbers from project extension B's features. This means that both project extension A and project extension B can use the error code 2000.

Note: MATRIXX reserves error codes 1000 through 1999 for MATRIXX use only; they are part of the base RS Gateway.

Extension projects should use error codes 2000 through 2999. MATRIXX professional services or customers can use these codes for their projects.