Basic net/http integration

Use this integration when GraphQL has its own listener or when a reverse proxy will route a dedicated public path to it. The schema is covered in Run your first server. This page only shows the HTTP integration.

Create the handlerCopy Anchor Link

func newHandler() (http.Handler, error) {
	server, err := grx.NewServer(
	grx.WithSchema(graph.Schema()),
	grx.WithPlaygroundPath("/"),
	)
	if err != nil {
		return nil, err
	}
	return server, nil
}

grx.NewServer returns an http.Handler. The default HTTP transport handles GraphQL JSON requests on /graphql.

Serve itCopy Anchor Link

server, err := newHandler()
if err != nil {
	log.Fatal(err)
}
log.Fatal(http.ListenAndServe(":4000", server))

Run the complete example with:

go run ./examples/basic

Add host middlewareCopy Anchor Link

Wrap the handler when you need CORS, authentication, request IDs, tracing, or other host-level policy. See CORS and browsers and HTTP middleware.

Other routersCopy Anchor Link

• ServeMux
• Chi
• Gin
• Echo
• Fiber

All integrations mount the same http.Handler. They do not change how the GraphQL schema or resolver methods work.

Related conceptsCopy Anchor Link

• Transports
• Runtime boundaries
• API reference for grx