Groups all operations related to the available topic.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mef-topic-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: '**This file forms part of Mplify 147**
**This API implements part of the Business Requirements & Use Cases described
in Mplify 133.1 section 12.**
List of use cases supported by Performance Monitoring Data Streaming Management API:
- List Available Topics for Subscription
- List Subscribed Topics
- Subscribe to a Topic
- Unsubscribe from a Topic
Most important entities supported by the API:
- **Topic** - metadata describing a topic available for subscription
- **Subscription** - contains…'
title: Streaming Management Topic API
version: 1.0.0
servers:
- url: https://{serverBase}/mefApi/allegro/streamingManagement/v1
variables:
serverBase:
default: mplify.net
description: The base of SOF's URL.
tags:
- description: Groups all operations related to the available topic.
name: Topic
paths:
/topic:
get:
description: List topics available for subscription to performance monitoring data
operationId: topicList
parameters:
- description: Category of the available topic
in: query
name: category
required: false
schema:
type: string
- description: A communication protocol supported by the available topic
in: query
name: protocol
required: false
schema:
type: string
- description: Requested number of elements to be provided in response requested by client
in: query
name: limit
required: false
schema:
format: int32
type: integer
- description: Requested index for the start of elements to be provided in response requested by the client. Note that the index starts with "0".
in: query
name: offset
required: false
schema:
format: int32
type: integer
responses:
'200':
content:
application/json;charset=utf-8:
schema:
items:
$ref: '#/components/schemas/Topic'
type: array
description: Success
headers:
X-Pagination-Throttled:
description: 'Used to indicate that the result page was throttled to a maximum possible size and there are additional results that can be fetched
'
schema:
type: boolean
X-Result-Count:
description: 'Actual number of items returned in the response body E.g. if there are 50 matching items in total, but the request has offset=10 and limit=10, then the X-Total-Count is 50.
'
schema:
type: integer
X-Total-Count:
description: Total number of items included in the response
schema:
type: integer
'400':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error400'
description: Bad Request
'401':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error401'
description: Unauthorized
'403':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error403'
description: Forbidden
'405':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error'
description: Method Not Allowed
'500':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error500'
description: Internal Server Error
summary: Retrieve Available Topics
tags:
- Topic
/topic/{id}:
get:
description: Information about the topic available for subscription
operationId: topicById
parameters:
- description: Identifier of the topic
in: path
name: id
required: true
schema:
type: string
responses:
'200':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Topic'
description: Success
'400':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error400'
description: Bad Request
'401':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error401'
description: Unauthorized
'403':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error403'
description: Forbidden
'404':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error404'
description: Not Found
'405':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error'
description: Method Not Allowed
'500':
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error500'
description: Internal Server Error
summary: Retrieve Available Topic by an Identifier
tags:
- Topic
components:
schemas:
ChannelDescription:
properties:
protocol:
description: Name of technical protocol allowing for consumption
type: string
description:
description: Human-friendly description of the protocol
type: string
required:
- protocol
type: object
Error500:
allOf:
- $ref: '#/components/schemas/Error'
- properties:
code:
description: 'The following error code:
- internalError: Internal server error - the server encountered an unexpected condition that prevented it from fulfilling the request.'
enum:
- internalError
type: string
required:
- code
type: object
description: Internal Server Error. (https://tools.ietf.org/html/rfc7231#section-6.6.1)
Error401:
allOf:
- $ref: '#/components/schemas/Error'
- properties:
code:
$ref: '#/components/schemas/Error401Code'
required:
- code
type: object
description: Unauthorized. (https://tools.ietf.org/html/rfc7235#section-3.1)
Error403:
allOf:
- $ref: '#/components/schemas/Error'
- properties:
code:
$ref: '#/components/schemas/Error403Code'
required:
- code
type: object
description: Forbidden. This code indicates that the server understood the request but refuses to authorize it. (https://tools.ietf.org/html/rfc7231#section-6.5.3)
Topic:
additionalProperties: true
description: 'Provides metadata describing a topic available for subscription. This object is used to define available consumption mechanisms and the data model.
'
properties:
id:
description: 'An identifier for the topic. This can be used to uniquely identify the topic within the Server system.
'
type: string
category:
$ref: '#/components/schemas/Category'
description: 'The category of the topic. This can be used to group topics based on their characteristics.
'
modelRef:
description: 'A reference to a model that describes the structure of the data associated with the topic.
'
format: uri
type: string
availableChannels:
description: 'An array of channel descriptions that provide information about the channels through which the topic can be accessed.
'
items:
$ref: '#/components/schemas/ChannelDescription'
minItems: 1
type: array
required:
- id
type: object
Error404:
allOf:
- $ref: '#/components/schemas/Error'
- properties:
code:
description: 'The following error code:
- notFound: A current representation for the target resource not found'
enum:
- notFound
type: string
required:
- code
type: object
description: Resource for the requested path not found. (https://tools.ietf.org/html/rfc7231#section-6.5.4)
Category:
description: 'The category of the topic. This can be used to group topics based on their characteristics.
'
enum:
- Layer 1
- Ethernet
- IP
- SD-WAN
- Computing
- Storage
- Memory
type: string
Error401Code:
description: 'One of the following error codes:
- missingCredentials: No credentials provided.
- invalidCredentials: Provided credentials are invalid or expired'
enum:
- missingCredentials
- invalidCredentials
type: string
Error400:
allOf:
- $ref: '#/components/schemas/Error'
- properties:
code:
$ref: '#/components/schemas/Error400Code'
required:
- code
type: object
description: Bad Request. (https://tools.ietf.org/html/rfc7231#section-6.5.1)
Error:
description: Standard Class used to describe API response error Not intended to be used directly. The `code` in the HTTP header is used as a discriminator for the type of error returned in runtime.
properties:
message:
description: Text that provides mode details and corrective actions related to the error. This can be shown to a client user.
type: string
reason:
description: Text that explains the reason for the error. This can be shown to a client user.
maxLength: 255
type: string
referenceError:
description: URL pointing to documentation describing the error
format: uri
type: string
required:
- reason
type: object
Error403Code:
description: 'This code indicates that the server understood the request but refuses to authorize it because of one of the following error codes:
- accessDenied: Access denied
- forbiddenRequester: Forbidden requester
- tooManyUsers: Too many users'
enum:
- accessDenied
- forbiddenRequester
- tooManyUsers
type: string
Error400Code:
description: 'One of the following error codes:
- missingQueryParameter: The URI is missing a required query-string parameter
- missingQueryValue: The URI is missing a required query-string parameter value
- invalidQuery: The query section of the URI is invalid.
- invalidBody: The request has an invalid body'
enum:
- missingQueryParameter
- missingQueryValue
- invalidQuery
- invalidBody
type: string