Skip to content
Microservice query language
Clojure Shell Dockerfile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
docker/nginx Add nginx to docker-compose Jun 13, 2017
ops/k8s Fixing service port. Dec 1, 2018
roadmap meetings
scripts chore(build): use jdk11 and lein 2.9.1 (#159) Aug 14, 2019
test context-path test...? Jan 10, 2020
.editorconfig chore(editor): add editorconfig Dec 10, 2018
.gitignore #41 Migrating log to log4j2 with async appender Nov 9, 2018
.travis.yml chore(build): use jdk11 and lein 2.9.1 (#159) Aug 14, 2019
Dockerfile chore: change dockerfile to use openjdk:11-jdk-slim (#104) Mar 13, 2019
LICENSE Initial commit Jan 9, 2017 fix query language nil Nov 7, 2019
docker-compose.yml chore(release): change to restQL-http and add release stage on travis Dec 6, 2018
project.clj bump version and core version to 3.5.7 Jan 8, 2020


restQL-http is a server to run restQL queries, making easy to fetch information from multiple services in the most efficient manner

restQL on travis-ci

Getting Started

Running restQL HTTP

restQL server allows you to post ad-hoc queries and to reference resources pre-configured in the server startup.

  1. Make sure you have Java 11 or superior installed,
  2. Download the latest release in the release page,
  3. Unzip the package,
  4. Configure resource mappings,
  5. Run bin/

Post to http://your-server.ip:9000/run-query the body below and content-type text/plain:

curl -H "Content-Type: text/plain" localhost:9000/run-query -d "from planets as allPlanets" 

For a more complex example follow this tutorial. Alternatively you can use our official docker image.

Our query language

The clause order matters when making restQL queries. The following is a full reference to the query syntax, available clauses and order.

[ [ use modifier = value ] ]

METHOD resource-name [as some-alias] [in some-resource]
  [ headers HEADERS ]
  [ timeout INTEGER_VALUE ]
  [ with WITH_CLAUSES ]
  [ [only FILTERS] OR [hidden] ]
  [ [ignore-errors] ]


from search
        role = "hero"

from hero as heroList
        name =

Learn more about restQL query language


Reach the community

Who's talking about restQL


Copyright © 2016-2019 B2W Digital

Distributed under the MIT License.

You can’t perform that action at this time.