Registry & System API

ENTWURF — Nur für interne Entwicklerteams

Diese API-Referenz ist für interne Entwicklerteams bestimmt.

Übersicht

Was es ist: Die Registry-API bietet Operationen auf Systemebene für Knotenverwaltung, Geheimniserzeugung und Client-Beitrittsoperationen.

Endpunkte

Methode	Pfad	Beschreibung	Authentifizierung erforderlich
GET	/internal/v1/registry/random/secret	Ein zufälliges Geheimnis generieren	JWT + API-Token
GET	/internal/v1/registry/advertise	Angekündigte Gateway-Adressen abrufen	JWT + API-Token
GET	/internal/v1/node/name/:nid	Knotennamen nach ID abrufen	JWT + API-Token
GET	/internal/v1/join/code/:code	Beitrittscode-Details abrufen	JWT + API-Token

Plattformbenutzer (verwendet von Control)

Methode	Pfad	Beschreibung	Authentifizierung erforderlich
GET	/internal/v1/registry/config/grid.user	Plattformbenutzer auflisten	JWT + API-Token
GET	/internal/v1/datastore/entity/:type/:userID	Benutzerentitäts-Details abrufen	JWT + API-Token

---

GET /internal/v1/registry/random/secret

Einen kryptografisch zufälligen Geheimnis-String generieren. Verwenden Sie diesen für die Erstellung von API-Tokens und Client-Geheimnissen.

Anfrage:

GET /internal/v1/registry/random/secret
Authorization: Bearer <token>

Antwort (200):

{
  "secret": "a1b2c3d4e5f6..."
}

---

GET /internal/v1/registry/advertise

Die angekündigten Gateway-Adressen für die Client-Registrierung abrufen.

Anfrage:

GET /internal/v1/registry/advertise
Authorization: Bearer <token>

Antwort (200):

{
  "addresses": [
    "https://gateway-01.hydden.com",
    "https://gateway-02.hydden.com"
  ]
}

---

GET /internal/v1/join/code/:code

Details für einen Client-Beitrittscode abrufen. Beitrittscodes werden während der Client-Registrierung verwendet.

Anfrage:

GET /internal/v1/join/code/ABC123
Authorization: Bearer <token>

Antwort (200):

{
  "code": "ABC123",
  "tenantId": "tenant-uuid",
  "expiresAt": "2026-02-13T10:00:00Z",
  "used": false
}

---

Control-Integration — Plattformbenutzer

Control verwendet diese Registry-Endpunkte, um Discovery-Plattformbenutzerdaten abzurufen:

Diagrammbeschreibung: Ein Sequenzdiagramm, das zeigt, wie Control Plattformbenutzerdaten von Discovery abruft. Control sendet eine GET-Anfrage an den Registry-Config-Endpunkt, um die Plattformbenutzerliste zu erhalten, und dann eine GET-Anfrage an den Datastore-Entity-Endpunkt, um Benutzerdetails abzurufen. Control ordnet die Ergebnisse seinem eigenen Plattformbenutzermodell zu.