GraphQL Abonnementen

Een GraphQL-abonnement is een websocket-verbinding waarbij de client een gebeurtenis met gegevens ontvangt telkens wanneer de waargenomen gebeurtenis upstream plaatsvindt.

Alle projecttabellen kunnen abonnementen ontvangen via het project-endpoint met behulp van het wss-protocol.

wss://archie-core.archie-platform.com/subscriptions?project_id=projectID

Voor alle voorbeelden gaan we uit van een scenario waarin een tabel genaamd students bestaat, met verwachte velden en relaties zoals firstName, email.

Een Nieuw Abonnement Maken

Om een nieuwe abonnementsconfiguratie te maken, gebruikt u de mutatie system { createSubscription }. Deze bewerking definieert de regels voor een abonnement, inclusief welke tabellen moeten worden bekeken en welke bewerkingen (Maken, Bijwerken, Verwijderen) een gebeurtenis moeten activeren.

GraphQL Mutatie

mutation createNewSubscription($input: SubscriptionInput!) {
  system {
    createSubscription(input: $input) {
      id
      active
      name
    }
  }
}

Variabelen

{
  "input": {
    "name": "students_all",
    "description": "Subscription all operations",
    "active": true,
    "tables": [
      {
        "table": "students",
        "operations": ["UPDATE", "CREATE", "DELETE"],
        "fields": ["first_name", "email"]
      }
    ]
  }
}