Suscripciones GraphQL

Una suscripción GraphQL es una conexión de web-socket donde el cliente recibe un evento con datos cada vez que ocurre el evento observado en el origen.

Todas las tablas de los proyectos pueden recibir suscripciones a través del punto final del proyecto utilizando el protocolo wss.

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

Para el propósito de los ejemplos, consideremos un escenario donde existe una tabla llamada students, que tiene campos y relaciones esperados como firstName, email.

Creando una Nueva Suscripción

Para crear una nueva configuración de suscripción, utiliza la mutación system { createSubscription }. Esta operación define las reglas para una suscripción, incluyendo qué tablas observar y qué operaciones (Crear, Actualizar, Eliminar) deben activar un evento.

Mutación GraphQL

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

Variables

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