Apache Zeppelin Helium REST API

Overview

Apache Zeppelin provides several REST APIs for interaction and remote activation of zeppelin functionality. All REST APIs are available starting with the following endpoint http://[zeppelin-server]:[zeppelin-port]/api. Note that Apache Zeppelin REST APIs receive or return JSON objects, it is recommended for you to install some JSON viewers such as JSONView.

If you work with Apache Zeppelin and find a need for an additional REST API, please file an issue or send us an email.

Helium REST API List

List of all available helium packages

Description This GET method returns all the available helium packages in configured registries.
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/all
Success code 200
Fail code 500
Sample JSON response 
{
  "status": "OK",
  "message": "",
  "body": {
    "zeppelin.clock": [
      {
        "registry": "local",
        "pkg": {
          "type": "APPLICATION",
          "name": "zeppelin.clock",
          "description": "Clock (example)",
          "artifact": "zeppelin-examples\/zeppelin-example-clock\/target\/zeppelin-example-clock-0.7.0-SNAPSHOT.jar",
          "className": "org.apache.zeppelin.example.app.clock.Clock",
          "resources": [
            [
              ":java.util.Date"
            ]
          ],
          "icon": "icon"
        },
        "enabled": false
      }
    ],
    "zeppelin-bubblechart": [
      {
        "registry": "local",
        "pkg": {
          "type": "VISUALIZATION",
          "name": "zeppelin-bubblechart",
          "description": "Animated bubble chart",
          "artifact": ".\/..\/helium\/zeppelin-bubble",
          "icon": "icon"
        },
        "enabled": true
      },
      {
        "registry": "local",
        "pkg": {
          "type": "VISUALIZATION",
          "name": "zeppelin-bubblechart",
          "description": "Animated bubble chart",
          "artifact": "zeppelin-bubblechart@0.0.2",
          "icon": "icon"
        },
        "enabled": false
      }
    ],
    "zeppelinhorizontalbar": [
      {
        "registry": "local",
        "pkg": {
          "type": "VISUALIZATION",
          "name": "zeppelinhorizontalbar",
          "description": "Horizontal Bar chart (example)",
          "artifact": ".\/zeppelin-examples\/zeppelin-example-horizontalbar",
          "icon": "icon"
        },
        "enabled": true
      }
    ]
  }
}


Suggest Helium application

Description This GET method returns suggested helium application for the paragraph.
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/suggest/[Note ID]/[Paragraph ID]
Success code 200
Fail code 404 on note or paragraph not exists
500
Sample JSON response 
{
  "status": "OK",
  "message": "",
  "body": {
    "available": [
      {
        "registry": "local",
        "pkg": {
          "type": "APPLICATION",
          "name": "zeppelin.clock",
          "description": "Clock (example)",
          "artifact": "zeppelin-examples\/zeppelin-example-clock\/target\/zeppelin-example-clock-0.7.0-SNAPSHOT.jar",
          "className": "org.apache.zeppelin.example.app.clock.Clock",
          "resources": [
            [
              ":java.util.Date"
            ]
          ],
          "icon": "icon"
        },
        "enabled": true
      }
    ]
  }
}


Load helium Application on a paragraph

Description This GET method returns a helium Application id on success.
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/load/[Note ID]/[Paragraph ID]
Success code 200
Fail code 404 on note or paragraph not exists
500 for any other errors
Sample JSON response 
{
  "status": "OK",
  "message": "",
  "body": "app2C5FYRZ1E-20170108-0404492068241472zeppelin_clock"
}


Load bundled visualization script

Description This GET method returns bundled helium visualization javascript. When refresh=true (optional) is provided, Zeppelin rebuild bundle. otherwise, provided from cache
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/visualizations/load[?refresh=true]
Success code 200 reponse body is executable javascript
Fail code 200 reponse body is error message string starts with ERROR:


Enable package

Description This POST method enables a helium package. Needs artifact name in input payload
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/enable/[Package Name]
Success code 200
Fail code 500
Sample input 
zeppelin-examples/zeppelin-example-clock/target/zeppelin-example-clock-0.7.0-SNAPSHOT.jar
Sample JSON response 
{"status":"OK"}


Disable package

Description This POST method disables a helium package.
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/disable/[Package Name]
Success code 200
Fail code 500
Sample JSON response {"status":"OK"}

Get visualization display order

Description This GET method returns display order of enabled visualization packages.
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/visualizationOrder
Success code 200
Fail code 500
Sample JSON response {"status":"OK","body":["zeppelin_horizontalbar","zeppelin-bubblechart"]}


Set visualization display order

Description This POST method sets visualization packages display order.
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/visualizationOrder
Success code 200
Fail code 500
Sample JSON input ["zeppelin-bubblechart", "zeppelin_horizontalbar"]
Sample JSON response {"status":"OK"}