`POST /v1/control/api-keys`.

curl --request POST \
  --url https://qa.esectra.com/v1/control/api-keys \
  --header 'Content-Type: application/json' \
  --cookie esectra_session= \
  --data '
{
  "label": "<string>"
}
'

import requests

url = "https://qa.esectra.com/v1/control/api-keys"

payload = { "label": "<string>" }
headers = {
    "cookie": "esectra_session=",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {cookie: 'esectra_session=', 'Content-Type': 'application/json'},
  body: JSON.stringify({label: '<string>'})
};

fetch('https://qa.esectra.com/v1/control/api-keys', 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://qa.esectra.com/v1/control/api-keys",
  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([
    'label' => '<string>'
  ]),
  CURLOPT_COOKIE => "esectra_session=",
  CURLOPT_HTTPHEADER => [
    "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://qa.esectra.com/v1/control/api-keys"

	payload := strings.NewReader("{\n  \"label\": \"<string>\"\n}")

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

	req.Header.Add("cookie", "esectra_session=")
	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://qa.esectra.com/v1/control/api-keys")
  .header("cookie", "esectra_session=")
  .header("Content-Type", "application/json")
  .body("{\n  \"label\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://qa.esectra.com/v1/control/api-keys")

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

request = Net::HTTP::Post.new(url)
request["cookie"] = 'esectra_session='
request["Content-Type"] = 'application/json'
request.body = "{\n  \"label\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "label": "<string>",
  "secret": "<string>"
}

POST

control

api-keys

`POST /v1/control/api-keys`.

curl --request POST \
  --url https://qa.esectra.com/v1/control/api-keys \
  --header 'Content-Type: application/json' \
  --cookie esectra_session= \
  --data '
{
  "label": "<string>"
}
'

import requests

url = "https://qa.esectra.com/v1/control/api-keys"

payload = { "label": "<string>" }
headers = {
    "cookie": "esectra_session=",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {cookie: 'esectra_session=', 'Content-Type': 'application/json'},
  body: JSON.stringify({label: '<string>'})
};

fetch('https://qa.esectra.com/v1/control/api-keys', 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://qa.esectra.com/v1/control/api-keys",
  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([
    'label' => '<string>'
  ]),
  CURLOPT_COOKIE => "esectra_session=",
  CURLOPT_HTTPHEADER => [
    "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://qa.esectra.com/v1/control/api-keys"

	payload := strings.NewReader("{\n  \"label\": \"<string>\"\n}")

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

	req.Header.Add("cookie", "esectra_session=")
	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://qa.esectra.com/v1/control/api-keys")
  .header("cookie", "esectra_session=")
  .header("Content-Type", "application/json")
  .body("{\n  \"label\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://qa.esectra.com/v1/control/api-keys")

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

request = Net::HTTP::Post.new(url)
request["cookie"] = 'esectra_session='
request["Content-Type"] = 'application/json'
request.body = "{\n  \"label\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "label": "<string>",
  "secret": "<string>"
}

Authorizations

esectra_session

string

required

A signed-in reviewer's session. httpOnly and SameSite=Lax; set by POST /v1/control/sessions and only usable once the second factor is met.

Body

application/json

What a new key is for.

label

string

required

A label. Required: it is the only thing distinguishing one key from another in the list, and an unlabelled key is one nobody dares revoke.

Response

Created; carries the secret, once

A newly created key, with its secret. The only response that carries one.

string

required

Identifier.

label

string

required

What it is for.

secret

string

required

The secret.

Returned exactly once, by this call, and never again: only its hash is stored, so there is nothing for a later request to return. The console must tell the person that before they navigate away.

Start

Verify

Operate

API reference

`POST /v1/control/api-keys`.

Errors

Authorizations

Body

Response