1. Documentation
2. 9.10 (Latest)9.99.89.79.69.59.49.39.29.19.08.28.18.07.6
3. Hub
4. REST API

REST API

RapidMiner AI Hub offers a REST API to manage it programmatically. In order to use the API, you are required to be authenticated and authorized via JSON Web Token (JWT).

Create a JWT using basic authentication

Use the following RapidMiner AI Hub REST endpoint to create a JWT:

[GET] $RMServerHost/api/rest/tokenservice

where$RMServerHostis the IP Address or host name of your RapidMiner AI Hub instance. The request needs to be authorized viaBasic Auth, use your RapidMiner AI Hub credentials to do so. If the request was successfully executed, you will get the following response body:

{ "idToken": "", "expirationDate": "" }

Use the value ofidTokento authorize your requests. TheexpirationDateindicates how long the JWT is valid, the default is 5 minutes. Once the token expires, you will need to create a new one by repeating the steps described above or you'll receive a 401 (unauthorized) response.

curl -u username:password $RMServerHost/api/rest/tokenservice

Create a JWT using an offline token

If you want to obtain the JWT in a fully programmatic way, you'll need to use an offline token, which can be requested as describedhere. Follow the steps there to get, first an offline, then an access token.

That access token can be used on this RapidMiner AI Hub REST endpoint to create a JWT:

[GET] $RMServerHost/api/rest/saml/tokenservice

where$RMServerHostis the IP Address or host name of your RapidMiner AI Hub instance.

使用响应值授权哟ur requests. The default expiration value is 5 minutes. Once the token expires, you will need to create a new one by repeating the steps described above or you'll receive a 401 (unauthorized) response.

curl -X GET $RMServerHost/api/rest/saml/tokenservice -H "Authorization: Bearer $idToken"

RapidMiner AI Hub API

The REST API documentation of RapidMiner AI Hub is available asOpenApi 3.0specification and is published onSwaggerHub.

For all further requests to the API you need to have

• the HTTP method of your request (GET, POST, PUT, PATCH or DELETE),
• the content-type header attribute,
• the authorization header attribute which includes theidTokenfrom the token service and is prefixed withBearer(e.g.Authorization: Bearer ),
• the RapidMiner AI Hub url and
• the route you like to make a request to.

curl -H "Content-Type: application/json" -H "Authorization: Bearer $idToken" $RMServerHost/executions/queues