Invoke CloudFunctions

curl --request POST \
  --url https://api.coinfer.ai/invoke \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target": "<string>",
  "action": "<string>",
  "parameters": {},
  "get_response": false
}
'

import requests

url = "https://api.coinfer.ai/invoke"

payload = {
    "target": "<string>",
    "action": "<string>",
    "parameters": {},
    "get_response": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({target: '<string>', action: '<string>', parameters: {}, get_response: false})
};

fetch('https://api.coinfer.ai/invoke', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinfer.ai/invoke",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'target' => '<string>',
    'action' => '<string>',
    'parameters' => [
        
    ],
    'get_response' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.coinfer.ai/invoke"

	payload := strings.NewReader("{\n  \"target\": \"<string>\",\n  \"action\": \"<string>\",\n  \"parameters\": {},\n  \"get_response\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.coinfer.ai/invoke")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"target\": \"<string>\",\n  \"action\": \"<string>\",\n  \"parameters\": {},\n  \"get_response\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.coinfer.ai/invoke")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"target\": \"<string>\",\n  \"action\": \"<string>\",\n  \"parameters\": {},\n  \"get_response\": false\n}"

response = http.request(request)
puts response.read_body

{
  "status": "ok",
  "data": "<unknown>"
}

Invoke

Invoke CloudFunctions

This API is used to run various tasks: run sample, run analyze, run CloudFunction.

The target parameter has two kinds of values:

Cloud Function ID (e.g. MARVIZPLOT). In this case, the action parameter must be run. The content in parameters is defined by the specific Cloud Function.
Workflow ID (e.g. F46FF98D7). In this case, the action parameter must be run_sample or run_analyze, and parameters should be empty or ignored.

The get_response parameter is used to indicate whether to synchronously and wait for the response from the command. If set to true, the API will wait for the command to finish and return the response. If set to false, the API will return immediately after the command is started.

The return format is also defined by the specific Cloud Function.

Example:

Arivz plot in serverside

// curl -H "Authorization: Bearer $token" "$root/invoke" --json \
{
    "target": "MARVIZPLOT",
    "action": "run",
    "get_response": true,
    "parameters": {
        "experiment_id": "X7CED97DD",
        "return_type": "json",
        "plot_func": "plot_ecdf",
        "plot_chain": "chain#1",
        "plot_var": "σ/val"
    }
}

// OUTPUT
{"status": "ok", "data": {"cloudfunction_response": {<plotdata>}}}

Run sample

// curl -H "Authorization: Bearer $token" "$root/invoke" --json \
{
    "target": "F46FF98D7",
    "action": "run_sample",
    "get_response": true
}

// OUTPUT
{"status": "ok", "data": {"experiment_id": "XFF2F7F8B", "experiment_name": "priceless_elion"}}

Run Analyze

// curl -H "Authorization: Bearer $token" "$root/invoke" --json \
{
    "target": "F46FF98D7",
    "action": "run_analyze",
    "get_response": false
}

// OUTPUT
{"status": "ok", "data": {}}

POST

invoke

Invoke CloudFunctions

curl --request POST \
  --url https://api.coinfer.ai/invoke \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target": "<string>",
  "action": "<string>",
  "parameters": {},
  "get_response": false
}
'

import requests

url = "https://api.coinfer.ai/invoke"

payload = {
    "target": "<string>",
    "action": "<string>",
    "parameters": {},
    "get_response": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({target: '<string>', action: '<string>', parameters: {}, get_response: false})
};

fetch('https://api.coinfer.ai/invoke', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinfer.ai/invoke",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'target' => '<string>',
    'action' => '<string>',
    'parameters' => [
        
    ],
    'get_response' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.coinfer.ai/invoke"

	payload := strings.NewReader("{\n  \"target\": \"<string>\",\n  \"action\": \"<string>\",\n  \"parameters\": {},\n  \"get_response\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.coinfer.ai/invoke")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"target\": \"<string>\",\n  \"action\": \"<string>\",\n  \"parameters\": {},\n  \"get_response\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.coinfer.ai/invoke")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"target\": \"<string>\",\n  \"action\": \"<string>\",\n  \"parameters\": {},\n  \"get_response\": false\n}"

response = http.request(request)
puts response.read_body

{
  "status": "ok",
  "data": "<unknown>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

target

string

required

Target object to perform the action on

action

string

required

Action to perform

parameters

Parameters · object

Parameters for the command

get_response

boolean

default:false

Whether to get the response from the command (Sync run)

Response

200 - application/json

SuccRsp[Any]
ErrRsp

status

string

required

Allowed value: "ok"

data

any

required

Guide

Object

Invoke

Notification

Authorization

Invoke CloudFunctions

Authorizations

Body

Response