GraphQL is not a new API format, but it’s definitely not as familiar or widely used as, say, REST. Because it’s less common, many developers hesitate when they have to interact with GraphQL. Once they get over the initial learning curve, they’re usually are quite pleased with it and can see the power and trade-offs it provides compared other API integrations.
At LinkTaco, we’re fully powered by GraphQL. We already provide some documentation on working with our API server, as well as a GraphQL Playground to test your queries. Today, we’re excited to share even more documentation to help developers better understand our schema.
Announcing our new api.linktaco.com site.
This site provides you the entire GraphQL API Schema on a single page. It shows all queries, mutations, directives, types, and more. You’ll even find example queries you can copy and paste into the GraphQL Playground for testing.
We hope this is useful and helps you create some awesome integrations with the platform. As always, feel free to email the development mailing list with any questions.
Of course, you can check out the repository for the new API docs if you want to see how the sausage is made. If you have any issues or suggestions, please don’t hesitate to let us know.
Thanks to Sourcehut
As always, the folks over at Sourcehut are churning out useful software at break-neck speeds. This documentation was made possible by Conrad Hoffman and his gockel tool for auto-generating GraphQL documentation. I, of course, used and modified the docs.sourcehut.org repo for their templates to create the documentation on api.linktaco.com.
Thanks to these tools, I was able to produce the new documentation site in under an hour.