For developers
The APIs - GraphQL
The API’s in Dataceen are implemented as GraphQL-APIs. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools. Read more about GraphQL here.
Dataceen GraphQL queries access not just the properties of one node but also smoothly follow relationships between them. While typical REST APIs require loading from multiple URLs, GraphQL APIs get all the data your app needs in a single request.
Documentation
Dataceen automatically generates comprehensive API documentation and code examples, take the short developer tour to discover more.
The query language
The Dataceen APIs contain an automatically generated query language implemented using the GraphQL standard. There are Find-methods that take filter-parameters, and what properties can be filtered on is determined by the model setup. This assures that you as a developer, don’t risk filtering data on properties that haven’t been properly indexed.
Example GraphQL:
query {
FindCar( size: 10, where: { or: [ { Brand: { eq: "Toyota" } }, { ModelYear: { gte: 2024 } } ] } ) {
Brand
Model
LicensePlate
}
}
Client languages
Dataceen can automatically generate code in different programming languages, for such languages there will be little or no need for learning GraphQL. Today, support exists for C# and Kotlin (Java), and more languages will follow.
Example C#:
var result = await _client.FindCarNodesAsync(10, null,
q=>q.Where(x => x.Brand == "Toyota" || x.ModelYear >= 2024),
f=>f.Fields(n=>n._allCarFields) );
Example Kotlin (Java):
val result = client.findCarNodesAsync(
size = 10,
cursor = null,
filter = carFilter {
or {
brand: { eq: "Toyota" }
modelYear: { gte: 2024 }
},
fields = carFields { }
)
Developer Tools
There are several tools available to be used when testing Dataceen APIs, and using them will give you a live API experience with code intelligence. In the tutorials we will use ‘GraphQL Playground Chrome Extension’ to show the APIs.
