Universal Connector Zuordnungen API

ENTWURF — Nur für interne Entwicklerteams

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

Übersicht

Was es ist: Die Zuordnungen-API verwaltet Feldzuordnungen für Universal Connectors. Zuordnungen definieren, wie Rohdatenfelder aus der Erfassung in das interne Entitätsmodell von Discovery übersetzt werden.

Endpunkte

Methode	Pfad	Beschreibung	Authentifizierung erforderlich
GET	/internal/v1/connector/universal/mappings	Alle Zuordnungen auflisten	JWT + API-Token
GET	/internal/v1/connector/universal/mappings/:id	Zuordnungsdetails abrufen	JWT + API-Token
PUT	/internal/v1/connector/universal/mappings	Eine Zuordnung erstellen oder aktualisieren	JWT + API-Token
DELETE	/internal/v1/connector/universal/mappings/:cid/:id	Eine Zuordnung löschen	JWT + API-Token
DELETE	/internal/v1/connector/universal/mappings/:cid/:id/erase	Zuordnung und Daten löschen	JWT + API-Token
GET	/internal/v1/connector/universal/generate/mapping-id/:connector/:id	Zuordnungs-ID generieren	JWT + API-Token
GET	/internal/v1/connector/universal/generate/mapping-uuid/:connector/:id	Zuordnungs-UUID generieren	JWT + API-Token

---

PUT /internal/v1/connector/universal/mappings

Eine Feldzuordnung für einen Universal Connector erstellen oder aktualisieren.

Anfrage:

PUT /internal/v1/connector/universal/mappings
Authorization: Bearer <token>
Content-Type: application/json

{
  "connectorId": "connector-uuid",
  "schemaId": "schema-uuid-001",
  "mappings": [
    { "source": "userId", "target": "Id", "required": true },
    { "source": "username", "target": "Account Name", "required": true },
    { "source": "email", "target": "Email", "required": false },
    { "source": "role", "target": "Account Type", "required": false }
  ]
}

Antwort (200):

{
  "id": "mapping-uuid-001",
  "connectorId": "connector-uuid",
  "status": "active",
  "fieldCount": 4
}

---

DELETE /internal/v1/connector/universal/mappings/:cid/:id/erase

Eine Zuordnung löschen und alle damit erfassten Daten entfernen.

Pfadparameter:

Parameter	Typ	Beschreibung
cid	string	Connector-ID
id	string	Zuordnungs-ID

Anfrage:

DELETE /internal/v1/connector/universal/mappings/connector-uuid/mapping-uuid-001/erase
Authorization: Bearer <token>

Antwort (204): Kein Inhalt.

DANGER

Diese Operation löscht die Zuordnung und alle zugehörigen erfassten Daten dauerhaft.