Applications on the web use APIs (application programming interfaces) to exchange and process data. If you want other services to access data from your web project, you need to develop and implement an interface like this one. There are some established standards like SOAP or REST, which provide a basic structure for your API. They can easily be controlled with any common programming language – the latter architecture especially has developed into a complete premium solution in the past years due to its simplicity.
But even though the success of REST architecture is quite impressive, there are still interesting alternatives such as GraphQL that are just as capable. The query language and runtime environment from the Facebook company can certainly keep up with SOAP and REST, although its advantages come into play for more complex queries, among other things.
Free IONOS API
Update domain, DNS, SSL settings and more with the IONOS API.
DNS managementEasy SSL adminAPI documentationGraphQL is an SQL-like query language including runtime environment and type system, developed by Facebook in 2012. Originally, it was intended exclusively for internal use. The background was the redesign of the native mobile Facebook apps for iOS and Android, which showed increasingly weaker performance due to the increasing complexity. Especially for the delivery of newsfeed data, the large corporation had to find an adequate solution in which the relationship between retrieved information and necessary server queries was satisfactory. In 2015, Facebook made the GraphQL source code freely available – by this time it had already regulated almost all data access for the mobile apps. Since 2017, the project has been running under the free OWFa 1.0 license (Open Web Foundation).
To understand how GraphQL works, you have to deal with the three elementary components that characterize the open source project:
The interplay of query language, type system, and runtime environment ensures a highly convertible API framework. This is not only accessible across platforms and applications, but can also be perfectly adapted to the characteristics of your web application. This means you can easily integrate the GraphQL interface into your project's code – regardless of whether you are using the Python framework Django, the Ruby framework Rails, or the JavaScript framework Node.js.
In order to protect your privacy, the video will not load until you click on it.
One of the main features of GraphQL is the simplicity of the query language, which makes it as easy as possible for developers to access the interface. Anyone who is familiar with GraphQL, for example, will quickly realize that the answers received perfectly mirror the questions asked. The output format is the JavaScript format JSON (JavaScript Object Notation). Consequently, sending an exactly fitting query is not a big challenge if you know the structure of the data that your application needs and formulate it in the query. In addition to the simple creation of queries, GraphQL has the following properties:
The great success of REST in the world wide web has already been mentioned as well as the fact that GraphQL is a serious alternative to this established HTTP-based and resource-oriented architecture for web services. This was made possible thanks to a development that led Facebook to develop GraphQL in the first place: the increasing importance and complexity of mobile web applications. Especially with these applications for Android, iOS, etc. the great strength of GraphQL as an API basis becomes apparent: it's possible to get access to all desired data with a single query.
The GraphQL server instance delivers exactly the information defined in the query, so that neither more nor less data than required is sent via the interface. With comparable REST APIs, you can only query one specific data set each time where it is completely displayed. In a direct comparison of "GraphQL vs. REST," Facebook's query concept proves to be much more precise and efficient, which benefits your application's performance. In turn, this pays off especially for users of mobile devices, who often only have less efficient internet connections.
In order to protect your privacy, the video will not load until you click on it.
While the freedom to retrieve data from GraphQL results in many positive features, it can also become a serious security problem, especially if you want to offer open APIs where you cannot control the query behavior of third-party clients. It is possible that too many queries could crash the server (intentionally or unintentionally). A scenario like this is less likely to affect you so quickly when using a REST API. It is therefore much more difficult to implement GraphQL in the backend in such a way that it runs reliably and with a high performance.
In addition, implementing a caching procedure for non-changeable queries with GraphQL is much more complicated than for queries via a REST interface. The latter can be cached using the caching methods of the HTTP specification (in the browser, for example).
GraphQL gives you the freedom to choose the underlying programming language, thanks to its wide range of ready-to-use libraries. This is also one of the great advantages when implementing a GraphQL interface in your app. For example, as a Python fan you can access the Graphene library – or work with the graphql-java|github.com: graphql-java library if your project is based on Java. If your web application is based on the JavaScript runtime environment Node.js, GraphQL.js, it is suitable as a basis for the implementation.
A list of available GraphQL libraries and client applications for various programming languages can be found on the official GraphQL website.
In the following GraphQL tutorial, we explain how to get started and what the first steps are with the API framework for a JavaScript application. In addition to the latter GraphQL.js library, the web framework Express is also used.
To use GraphQL libraries, you must first install them. For the JavaScript library GraphQL.js, you should use the JavaScript package manager npm (Node Package Manager) and the following command:
npm install --save graphql Alternatively, you can also get the library from the package and dependency manager Yarn, developed by Facebook (mostly) and Google:
yarn add graphql In both cases, a current version of Node.js must be installed (recommended: Node v6.0.0 or higher).
To enable your application to process GraphQL queries, you need a scheme that defines the type "query" and the access point to your interface (also called API root) including resolver function. For a simple GraphQL sample interface that only outputs the message "Hello world," the appropriate code in the server.js file created for this purpose would look like this:
var { graphql, buildSchema } = require('graphql');
// Build schema based on the GraphQL concept
var schema = buildSchema(`
type Query {
hello: String
}
`);
// API root provides a resolver function for each accessing endpoint
var root = {
hello: () => {
return 'Hello world!';
},
};
// Execute GraphQL query '{ hello }' and display the corresponding answer graphql(schema, '{ hello }', root).then(response => {
console.log(response);
}); Now execute this code with Node.js by entering the command in the terminal.
node server.js You should then receive the following message:
{ data: { hello: 'Hello world!' } } After you have created a simple query in the previous step and executed it from the command line, it is now time to run a GraphQL API server. This allows the interface to be accessed, for example, via a standard web browser. To do this, first install the application framework Express mentioned above and the library express-graphql with the following command:
npm install express express-graphql --save Then modify the "Hello world!" GraphQL example so that it becomes the basis of your GraphQL server instead of a simple script. To do this, implement the Express module and use the express-graphql library to connect the API server to the HTTP endpoint "/graphql":
var express = require('express');
var graphqlHTTP = require('express-graphql');
var { buildSchema } = require('graphql');
// Build schema based on the GraphQL concept
var schema = buildSchema(`
type Query {
hello: String
}
`);
// API root provides a resolver function for each accessing endpoint
var root = {
hello: () => {
return 'Hello world!';
},
};
var app = express();
app.use('/graphql', graphqlHTTP({
schema: schema,
rootValue: root,
graphiql: true
}));
app.listen(4000);
console.log('Ececute GraphQL API server on localhost:4000/graphql'); As in the previous GraphQL example, open the server.js file with Node.js – with the difference that this time you are not executing a simple query but starting your API server:
node server.js The code of the GraphQL Express server not only specifies the scheme and root API, but also the HTTP endpoint "/graphql." The "graphiql: true" entry activates the tool of the same name, which allows you to enter queries via a graphical user interface. Simply open your browser and enter the following address:
http://localhost:4000/graphql After you have installed the necessary components in the various steps of this GraphQL tutorial, created your first query schema, and started your own server, you can then familiarize yourself with all the possible query inputs at your leisure.
More information and detailed explanations on GraphQL backends and frontends can be found in the tutorial section on the official website of the Facebook API concept.
Combining different application systems has become increasingly important over the past few years. This trend is especially due to the increasing number of web applications being developed. In order to react to this trend, many different web services were developed that make data transfer across multiple systems possible. The Representational State Transfer (REST) is an architectural style that...
REST (Representational State Transfer) plays an important role in the development of modern web applications. Part of the concept, which distinguishes itself from comparable solutions due to its demand for a universal interface, is an internal application structure that follows the HATEOAS approach. This article reveals what’s behind this acronym and why exactly HATEOAS is so important for REST.
Many IT departments need communication between various applications to work swiftly and without errors. For example, lost messages or a bottleneck of messages can lead to expensive problems in the financial industry. With the AMQP protocol, problems like these don't occur. How does the Advanced Message Queuing Protocol work?
Website operators usually like it whenever their content is shared on social media. However, occasionally the way it is displayed leaves much to be desired. The Open Graph protocol (OGP) allows you to optimize your website’s preview. Using Open Graph tags can help generate more likes and clicks.
There are plenty of models for processing and storing large quantities of data. However, conventional databases with their rigid tabular structures quickly reach their limits when modeling complex relationships. So-called ‘graph databases’ have proven themselves to be particularly efficient for dealing with intensely interconnected data. But what exactly can they do?
Provide powerful and reliable service to your clients with a web hosting package from IONOS.
View packages