Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can run queries on real Scope data using any HTTP compliant client (HTTP Client) or GraphQL integrated development environment (GraphQL IDE). GraphQL IDEs are typically easier to work with because they include docs, syntax highlighting, and validation errors.

...

Scope GraphQL Explorer is an instance of GraphiQL (a GraphQL IDE) that is available in-browser at https://cms.scopear.com/api/v3/graphql/explorer.

Note

Note: Scope has temporarily disabled the Explorer, but you can still explore the graph using a local GraphiQL client, or any other similar client (see below).

Using GraphiQL

To use the GraphiQL app, download and install it from https://www.electronjs.org/apps/graphiql.

...

  1. Get an OAuth token.

  2. Launch GraphiQL.

  3. In the upper-right corner of GraphiQL, click Edit HTTP Headers.

  4. In the upper-right corner of the modal dialog, click + Add Header.

  5. In the Key field, enter Authorization. In the Value field, enter Token token=<token>, where <token> is your generated OAuth token.

  6. Click the checkmark to the right of the token to save it.

  7. In the upper-right corner of the modal dialog, click + Add Header.

  8. In the Key field, enter PrivateAccessCode. In the Value field, enter Token token=YWRtaW4xMjU6c2VjcmV0MTI1, where YWRtaW4xMjU6c2VjcmV0MTI1 is a literal value (used to enable early access to the Scope GraphQL API).

  9. Click the checkmark to the right of the token to save it.

  10. To return to the editor, click outside of the Edit HTTP Headers modal.

  11. In the GraphQL Endpoint field, enter https://cms.scopear.com/api/v3/graphql.

  12. In the Method dropdown menu, select POST.

Note: For more information about why POST is the method, see "Communicating with GraphQL."

You can test your access by querying yourself:

...

  1. “Permanent” API tokens that never expire.

  2. “Temporary” Session based tokens that expire after a relatively short period of time, 30 days (or “sign-out”, whichever is earlier).

To obtain a permanent API token:

...