Contents x
    Publish message to the server
    • 26 Mar 2024
    • 4 Minutes to read
    • Print
    • Dark
      Light
    Contents

    Publish message to the server

    • Updated on 26 Mar 2024
    • 4 Minutes to read
    • Print
    • Dark
      Light
    Article Summary

    Post
    /v2/tenants/{tenantId}/projects/{projectId}/topics/{topicId}:publish

    Publish single or multiple messages to the server via a topic

    Security
    API Key
    Header parameter nameAuthorization

    AWS Cognito Authorizer. Since there are no custom scopes the ID Token must be used for authorization

    Header parameters
    Content-Type
    stringRequired
    Path parameters
    tenantId
    stringRequired

    The RapidIdentity Cloud tenant id

    projectId
    stringRequired

    The project id this service belongs (i.e. sm, idhub, ric)

    topicId
    stringRequired

    The routing key name. Must not contain builtin_ or custom_ as these are reserved words

    Body parameters

    The messages in the request to publish

    PublishMessagesExample

    Publish one message to topic

    {
  "messages": [
    {
      "data": "InsgXCJIZWxsb1wiOiBcIldvcmxkXCIgfSI=",
      "attributes": {
        "Content-Type": "application/json"
      }
    }
  ]
}
    Expand All
    object
    messages
    Array of object (PubsubMessage) Required

    The messages to publish

    object
    data
    string (bytes)

    Optional. The message data. If this field is empty, the message must contain at least one attribute

    A base64-encoded string

    attributes
    object

    Optional. Metadata attributes for this message. If this field is empty, the message must contain non-empty data

    messageId
    string

    Optional. ID of this message, assigned by the server when the message is published. Guaranteed to be unique within the topic. This value must not be populated by the publisher. Read-Only

    publishTime
    string (Timestamp)

    Optional. The time at which the message was published, populated by the server when the message is published. Read-Only

    Responses
    200

    200 response

    Headers
    Content-Type
    string
    Content-Length
    string
    Cache-Control
    string
    object
    messageIds
    Array of string

    The server assigned ID of each published message, in the same order as the messages in the request. IDs are guaranteed to be unique within the topic

    string
    400

    An issue with how the request was formatted

    Headers
    Content-Type
    string
    Content-Length
    string
    Cache-Control
    string
    Expand All
    object
    error
    object

    The error message description

    errors
    Array of object

    The more detailed information about the error message

    object
    domain
    string

    The service where the error occured. i.e. sm, idhub

    reason
    string

    The reason for the error based on Identity Automation common error codes

    message
    string

    Additional details about the error

    locationType
    string

    The specific location where the error occurred. i.e. parameter, content

    location
    string

    The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

    code
    string

    The http status code

    message
    string

    Additional details about the error

    401

    The request is not authorized. Ensure you are using an ID Token in your request and it is not expired

    Headers
    Content-Type
    string
    Content-Length
    string
    Cache-Control
    string
    Expand All
    object
    error
    object

    The error message description

    errors
    Array of object

    The more detailed information about the error message

    object
    domain
    string

    The service where the error occured. i.e. sm, idhub

    reason
    string

    The reason for the error based on Identity Automation common error codes

    message
    string

    Additional details about the error

    locationType
    string

    The specific location where the error occurred. i.e. parameter, content

    location
    string

    The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

    code
    string

    The http status code

    message
    string

    Additional details about the error

    403

    The authorization token does not have access to the RapidIdentity Cloud Tenant. Ensure the tenantId used for authentication is the same one used in this request.

    Headers
    Content-Type
    string
    Content-Length
    string
    Cache-Control
    string
    Expand All
    object
    error
    object

    The error message description

    errors
    Array of object

    The more detailed information about the error message

    object
    domain
    string

    The service where the error occured. i.e. sm, idhub

    reason
    string

    The reason for the error based on Identity Automation common error codes

    message
    string

    Additional details about the error

    locationType
    string

    The specific location where the error occurred. i.e. parameter, content

    location
    string

    The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

    code
    string

    The http status code

    message
    string

    Additional details about the error

    404

    The requested operation failed because a resource associated with the request could not be found

    Headers
    Content-Type
    string
    Content-Length
    string
    Cache-Control
    string
    Expand All
    object
    error
    object

    The error message description

    errors
    Array of object

    The more detailed information about the error message

    object
    domain
    string

    The service where the error occured. i.e. sm, idhub

    reason
    string

    The reason for the error based on Identity Automation common error codes

    message
    string

    Additional details about the error

    locationType
    string

    The specific location where the error occurred. i.e. parameter, content

    location
    string

    The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

    code
    string

    The http status code

    message
    string

    Additional details about the error

    405

    The operation must be included and it must be publish

    Expand All
    object
    error
    object

    The error message description

    errors
    Array of object

    The more detailed information about the error message

    object
    domain
    string

    The service where the error occured. i.e. sm, idhub

    reason
    string

    The reason for the error based on Identity Automation common error codes

    message
    string

    Additional details about the error

    locationType
    string

    The specific location where the error occurred. i.e. parameter, content

    location
    string

    The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

    code
    string

    The http status code

    message
    string

    Additional details about the error

    503

    Unable to connect to pubsub service

    Headers
    Content-Type
    string
    Content-Length
    string
    Cache-Control
    string
    Expand All
    object
    error
    object

    The error message description

    errors
    Array of object

    The more detailed information about the error message

    object
    domain
    string

    The service where the error occured. i.e. sm, idhub

    reason
    string

    The reason for the error based on Identity Automation common error codes

    message
    string

    Additional details about the error

    locationType
    string

    The specific location where the error occurred. i.e. parameter, content

    location
    string

    The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

    code
    string

    The http status code

    message
    string

    Additional details about the error

    Was this article helpful?
    What's Next