Low-level GraphQL client for Go. Fork of github.com/machinebox/graphql
- Simple, familiar API
- Respects
context.Contexttimeouts and cancellation - Build and execute any kind of GraphQL request
- Use strong Go types for response data
- Use variables and upload files
- Simple error handling
Make sure you have a working Go environment. To install graphql, simply run:
$ go get github.com/machinebox/graphql
import "context"
// create a client (safe to share across requests)
client := graphql.NewClient("https://gql-api/")
// make a request
req := graphql.NewRequest(`
query ($key: String!) {
items (id:$key) {
field1
field2
field3
}
}
`)
// set any variables
req.Var("key", "value")
// set header fields
req.Header.Set("Cache-Control", "no-cache")
// define a Context for the request
ctx := context.Background()
// run it and capture the response
var respData ResponseStruct
if err := client.Run(ctx, req, &respData); err != nil {
log.Fatal(err)
}By default, the package will send a JSON body. To enable the sending of files, you can opt to
use multipart form data instead using the UseMultipartForm option when you create your Client:
client := graphql.NewClient("https://gql-api/", graphql.UseMultipartForm())
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent