website logo
➡️ purplepublish.com
Overview
Support
Setup
Editorial
Experience
Growth
Developers
Navigate through spaces
⌘K
Developers Documentation
Catalog-API
Hub Import API
Entitlement services
Purple Growth – Setup
Custom S3 Buckets
Dynamic Resources
Docs powered by
Archbee
Developers Documentation
Catalog-API

Subscription-API

7min

With the Catalog Subscription API, developers get access to a stream of events related to and app or team.

This documentation is intended for technical users (integrators and developers). 

This documentation assumes familiarity with GraphQL. Please read the official website's Introduction to GraphQL to learn about the concepts if you have never worked with GraphQL before.

Introduction

What are Events?

When working with the Purple DS Content Cloud all actions related to content are processed by an event streaming platform. When an editor publishes a new article or and updated revision of an article, this change gets processed by our Content Pipeline and eventually lands in the database used by clients to access the contents.

What is the Subscription API?

The Subscription API is a backend service that implements GraphQL subscriptions specification. With it you can start a WebSocket connection to our backend service and get real-time delivery of Content Pipeline events.

After subscribing to events your GraphQL client will receive all events matching the query. If the WebSocket connection between the backend and client is interrupted you will receive all events queued since the last subscription. The state is stored based on all query parameters. If any of the parameters changes, a new subscription is created.

The state of your subscription is kept for 7 days. After that all state is deleted and resubscription will lead to only new events being delivered.

Usage

Connection

The API endpoint is available at wss://catalog.purplemanager.com/subscriptions/subscriptions (Secure WebSocket connection)

A web-based schema exploration and query sandbox is available at https://catalog.purplemanager.com/subscriptions/graphiql

Updated 28 Aug 2023
Did this page help you?
PREVIOUS
Catalog-API
NEXT
Hub Import API
Docs powered by
Archbee
TABLE OF CONTENTS
Introduction
What are Events?
What is the Subscription API?
Usage
Connection
Docs powered by
Archbee
ImprintPrivacy Policy
© Sprylab Technologies GmbH 2023