You know the basics of GraphQL, but you are still uncertain about how to get business content and API structures right in GraphQL?

GraphQL is indeed an attractive data API for applications (and people). The GraphQL Schema is pivotal to the success of a GraphQL API in that it describes an application side scope as well as the mapping to data sources.

There are many contexts, where complex structures and semantics must be communicated effectively, and the trick invariably turns out to be: Use good visualizations! Most development projects involve many stakeholders. There are the developers, of course, and there are business ecperts as well as application owners, who are to consume the content of the API.

The main proposition of this book is graph visualization: GraphQL Schema structure and meaning must be visualized, and the book shows you how. Since the schema is a “data graph” containing related concepts in a network organized as a directed graph, the increasingly popular property graph paradigm is very appropriate for visualizing GraphQL structures and semantics.

The second theme of this book is that of quality of the content. GraphQL APIs can be used in many constellations possibly including legacy data and/or externally sourced data. Quality must be ensured in all cases. The book contains simple guidelines based on lessons learned from real life data discovery and unification. This helps developers and architects to get good quality in the resulting API designs. And the visual techniques help in producing convincing visual communication about the structure of the API designs.

Spending time on schema quality means that developers work from sharp definitions, which in turn leads to greater productivity and well-structured applications.