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

Get 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/package
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
      }
    ]
  }
}

Get all enabled helium packages

Description This GET method returns all enabled helium packages in configured registries.
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/enabledPackage
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
      }
    ]
  }
}

Get single helium package

Description This GET method returns specified helium package information
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/package/[Package Name]
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
      }
    ]
  }
}

Suggest Helium package on a paragraph

Description This GET method returns suggested helium package 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 package on a paragraph

Description This POST method loads helium package to target paragraph.
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
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 rebuilds bundle. Otherwise, it's provided from cache
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/bundle/load/[Package Name][?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/order/visualization
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/order/visualization
Success code 200
Fail code 500
Sample JSON input ["zeppelin-bubblechart", "zeppelin_horizontalbar"]
Sample JSON response {"status":"OK"}

Get configuration for all Helium packages

Description This GET method returns configuration for all Helium packages
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/config
Success code 200
Fail code 500

### Get configuration for specific package

Description This GET method returns configuration for the specified package name and artifact
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/config/[Package Name]/[Artifact]
Success code 200
Fail code 500

Set configuration for specific package

Description This POST method updates configuration for specified package name and artifact
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/config/[Package Name]/[Artifact]
Success code 200
Fail code 500


### Get Spell configuration for single package

Description This GET method returns specified package Spell configuration
URL http://[zeppelin-server]:[zeppelin-port]/api/helium/spell/config/[Package Name]
Success code 200
Fail code 500