graphql-showcase

README

GraphQL Showcase

A GraphQL wrapper for (parts of) the GAPIC Showcase API.

This project contains a simple and rough wrapper for a few methods of the GAPIC Showcase API, and is intended to provide an example of manual integration of a gRPC API into a GraphQL service.

It uses the graphql-go package.

This repository is temporary. This code is published to support the workshop Implementing OpenAPI and GraphQL Services with gRPC at the 2019 API Specifications Conference. It is intended for submission later into an experimental subdirectory of GAPIC Showcase.

Credits

Contents of the static directory are manually vendored from github.com/graphql/graphiql.

Installation

go get github.com/timburks/graphql-showcase

Invocation

Just run the graphql-showcase program. It currently takes no options and expects a GAPIC Showcase server to be running locally on port 7469 (the default).

Usage

After you've started the graphql-showcase server, visit http://localhost:8080 to open the GraphiQL browser. Then use standard GraphQL to explore the schema and make queries. For example, to create a new user, enter:

mutation {
  createUser(display_name:"me", email:"me@example.com") {
    id
    display_name
    email
  }
}

To see a list of users, enter:

{
  users {
    id
    display_name
    email
  }
}

To delete a user, enter:

mutation {
  deleteUser(id:"users/10") {
    id
  }
}

Go Version Supported

This code was developed with Go 1.12.

Disclaimer

This is not an official Google product.