API Reference

Artifacts

Signed, short-lived plugin downloads for node agents

GET /api/artifacts/{token}

Download a plugin artifact using a signed link

Called by a node agent, not by an operator. The link names one plugin version for one network and expires; it is minted by the install call when the artifact lives in a maven repository the node cannot authenticate to.

Parameters

token string path required

Responses

200 The jar.
403 Missing, malformed or invalid signature.
410 The link has expired; install again to mint a new one.

403 response

{
  "error": "string"
}

Request

curl -X GET https://api.beehivesys.net/api/artifacts/{token} \
  -H "X-Hive-Api-Key: $HIVE_API_KEY"

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.beehivesys.net/api/artifacts/{token}"))
    .header("X-Hive-Api-Key", apiKey)
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response =
    client.send(request, HttpResponse.BodyHandlers.ofString());