GraphQL Support

Bifurc includes first-class GraphQL request and mock workflows, plus schema-aware tooling for exploration and authoring.

---

What you can do

• save GraphQL requests with endpoint, query, variables, and headers
• introspect schemas from a running endpoint
• store SDL or introspection results in the workspace
• generate starter operations from discovered schema fields
• mock GraphQL responses by endpoint, operation type, and operation name
• use environment variables across endpoints, variables, headers, and scripts

---

Typical workflow

1. Open Request → GraphQL
2. Create a request tab
3. Enter the endpoint URL
4. Introspect the schema or attach a saved schema
5. Generate or write a query
6. Add variables and headers
7. Send the request
8. Save it into the workspace for repeat use

---

Mocking workflow

1. Open Mock → GraphQL
2. Create a mock
3. Match by endpoint pattern
4. Choose an operation type: query, mutation, subscription, or any
5. Optionally specify an operation name
6. Define the response status, headers, and body
7. Enable the mock and route traffic through Bifurc

---

Matching model

GraphQL proxy-level mocking is operation-aware:

• request body must parse as JSON
• Bifurc reads query, operationName, and variables
• operation type is detected from the GraphQL document
• enabled mocks are checked for endpoint and operation compatibility

---

Good use cases

• frontend work against incomplete backends
• contract testing for specific operations
• mocking mutations without touching production-like services
• keeping reusable GraphQL examples in git-backed workspaces