Zum Inhalt springen

Produkte

Teil der API-Referenz. Authentifizierung, Scopes, Anfragegrenzen und Fehler stehen im Überblick.

BitHive Reporting Desk API · 0.11.0

Produkte

GET/v1/products

Produkte des Kontos auflisten

Gibt die Produkte zurück, die das Token sehen darf: alle Produkte des Kontos oder nur das eine, auf das das Token beschränkt ist. Archivierte Produkte sind enthalten und als solche gekennzeichnet.

Scope: products:read

Antworten

200 Die Produkte, die das Token sehen darf. ProductList

{
  "products": [
    {
      "id": "3f1b0c9e-6a27-4f5b-9c1d-2e8a7b4d5c60",
      "name": "Fleet Service",
      "created_at": "2026-08-03T09:12:44Z",
      "archived": false
    },
    {
      "id": "8c2d4e6a-15b3-4a7c-8e90-1d2f3a4b5c6d",
      "name": "Device Bridge",
      "created_at": "2026-08-19T14:05:02Z",
      "archived": false
    }
  ]
}

Beispiel

curl --fail-with-body -sS \
  -H "Authorization: Bearer $BITHIVE_TOKEN" \
  "https://app.bithive-it.com/v1/products"

GET/v1/products/{productId}

Ein Produkt lesen

Gibt das Produkt zurück. Ein Produkt eines anderen Kontos und ein Produkt, auf das das Token nicht beschränkt ist, werden als nicht gefunden gemeldet.

Scope: products:read

Parameter

ParameterWoTypBeschreibung
productId erforderlichpathstring (uuid)Kennung des Produkts.

Antworten

200 Das Produkt. Product

{
  "id": "3f1b0c9e-6a27-4f5b-9c1d-2e8a7b4d5c60",
  "name": "Fleet Service",
  "created_at": "2026-08-03T09:12:44Z",
  "archived": false
}

Beispiel

curl --fail-with-body -sS \
  -H "Authorization: Bearer $BITHIVE_TOKEN" \
  "https://app.bithive-it.com/v1/products/$PRODUCTID"

Der Vertrag selbst. Diese Seite entsteht aus dem OpenAPI-Dokument des Dienstes. Es ist als Datei veröffentlicht, damit ein Client-Generator denselben Vertrag lesen kann, den diese Seite beschreibt. openapi.yaml herunterladen

Doku

14 Tage kostenlos testen