RestQL Http Save Abandoned

Microservice query language

Project README


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

To Do

  • Create endpoints for creating and updating queries and resources (#178)
  • Implement a soft cache reset when resources are created or updated (#179)
  • Unify cache locations in restQL-http (#180)


Copyright © 2016-2019 B2W Digital

Distributed under the MIT License.

Open Source Agenda is not affiliated with "RestQL Http" Project. README Source: b2wdigital/restQL-http
Open Issues
Last Commit
2 years ago

Open Source Agenda Badge

Open Source Agenda Rating