id: api-reference title: API reference sidebar_label: Overview

This topic is an index to the ApacheĀ® Druid API documentation.

Set druid.server.http.enableResponseIdentityHeaders to true to include headers on every HTTP response that identify the Druid service which generated the response:

HeaderDescription
X-Druid-ServerAdvertised host and port of the Druid server that generated the response.
X-Druid-ServiceService name of that Druid server, as configured by druid.service.
X-Druid-VersionVersion of that Druid server.

When a Router proxies a request, it passes through these headers from the upstream Druid server instead of returning the Router's identity. If the upstream server does not return all three headers, the Router does not return any of them. If the Router generates the response itself, the headers identify the Router.

This feature is disabled by default because the headers may expose internal hostnames, IP addresses, ports, and the Druid version. Only enable it when clients are authorized to receive this information.

HTTP APIs

Java APIs

  • Druid JDBC driver to connect to Druid and make Druid SQL queries over JDBC. This is the recommended JDBC driver.
  • Avatica JDBC driver to make Druid SQL queries using the Apache Calcite Avatica driver instead.