Skip to main content

GraphQL

Swan exposes a GraphQL API. Anyone can try it out on the API Explorer in Sandbox mode.

Schemas

Update GraphQL schemas with the following command:

$ yarn graphql-update-schemas
info

Versioned schemas are stored in the repository to maintain consistent Continuous Integration (CI).

Documents

All required documents are in the graphql directory for each application.

Replace $consentId with your consent ID.

clients/banking/src/graphql/partner.gql
query ConsentCallbackPage($consentId: ID!) {
consent(id: $consentId) {
id
status
}
}

# ...

Code generator

In order to benefit from GraphQL's types, we use GraphQL Codegen.

Run codegen with the following command:

$ yarn graphql-codegen

In this example, codegen generates a new file partner.ts, housed with documents, which we can import:

import { ConsentCallbackPageDocument } from "../graphql/partner";

const MyComponent = () => {
const [{ data }] = useUrqlQuery({ query: ConsentCallbackPageDocument });
// `data` is a typed object
// ...
};
info

Generated files are not versioned to avoid unnecessary conflicts. Instead, they're generated with CI.

🚀 Any questions? Help improve this project and the docs by opening a GitHub discussion.