Bevor Sie beginnen
- Einen aktiven Agenten aus demselben Arbeitsbereich und derselben Umgebung wie Ihre Anmeldeinformationen verwenden.
- Anfragen mit einem Workspace-API-Schlüssel oder einem angemeldeten Workspace-Benutzer erstellen.
- Prüfer müssen aktive menschliche Workspace-Mitglieder mit der Workspace-Berechtigung
tenant:governance:approvesein. Eine reine Organisationsrolle ist nicht ausreichend. - Der Anfragende kann seine eigene Anfrage nicht genehmigen oder ablehnen. Jeder Prüfer kann einmal entscheiden. API-Schlüssel können keine menschlichen Stimmen abgeben.
Eine Anfrage erstellen
Dieses Beispiel fordert zwei unabhängige Genehmigungen innerhalb eines einstündigen Fensters an. Ersetzen Sie den Agent-Bezeichner durch einen vorhandenen Sandbox-Agenten; ein Produktions-Agent kann nicht mit einem Sandbox-Anmeldeinformationen verwendet werden.201-Antwort enthält id, requested_by, status: "pending", current_approvals: 0 und expires_at. Speichern Sie id; die Erstellung veröffentlicht den Bericht nicht und erstellt keinen Hintergrund-Workflow.
Überprüfung mit einer menschlichen Sitzung
Verwenden Sie die Console für interaktive Entscheidungen. Wenn Ihre Integration die API verwendet, geben Sie die kurzlebige Bearer-Sitzung des Prüfers für den Arbeitsbereich an. Ersetzen Sie keinen API-Schlüssel und betten Sie kein Sitzungstoken in den Quellcode ein.status: "pending" und current_approvals: 1 zurück. Ein anderer autorisierter Prüfer muss die zweite Stimme abgeben. Die Wiederverwendung desselben Prüfers führt zu einem Konflikt. Eine Ablehnung ändert die Anfrage sofort in rejected, unabhängig von früheren Genehmigungen.
Der Dienst überprüft aktuelle Mitgliedschaftsberechtigungen, Anfragenbesitz, Ablauf und bestehende Abstimmungen innerhalb der Entscheidungstransaktion. Abstimmungen und das Audit-Ereignis werden zusammen festgeschrieben. Entscheidungen können über diese APIs nicht bearbeitet oder gelöscht werden.
Ergebnis prüfen und durchsetzen
status approved ist und die Anfrage immer noch dem genauen Agenten, der Aktion, der Ressource und dem Umfang entspricht, die Ihre Anwendung verwenden möchte. Ihre Anwendung muss auch die aktuellen Zugriffsberechtigungen, den Agentenstatus und ihre eigenen Einmal- oder Wiederholungssteuerungen durchsetzen. Diese Genehmigungsdatensätze bieten keinen automatischen Ausführungs- oder Verbrauchsmechanismus.
Die Überprüfungsfrist begrenzt, wann Entscheidungen eingereicht werden können. Sie verwandelt eine bereits genehmigte Anfrage nicht in ein ablaufendes Zugriffstoken. Definieren Sie jede Ausführungsfrist in Ihrer eigenen Anwendung.
Warteschlange, Stornierung und Fehler
GET /v1/approvals gibt ein Array von höchstens 100 ältesten ausstehenden, nicht abgelaufenen Anfragen zurück. Es hat keine Paginierung oder historischen Statusfilter. Die Warteschlange lässt die individuelle Entscheidungshistorie aus; rufen Sie eine Anfrage nach ID ab, um diese Historie zu erhalten.
Der ursprüngliche Anfragende kann POST /v1/approvals/{approvalID}/cancel mit einem nicht leeren reason senden. Eine Anfrage kann nach Stornierung, Ablehnung, Genehmigung oder Ablauf nicht wieder geöffnet werden. Erstellen Sie eine neue Anfrage, wenn sich die vorgeschlagene Aktion ändert.
Diese Aufzeichnungen unterstützen Ihren Überprüfungsprozess; sie begründen keine SOC 2-Konformität, ISO-Zertifizierung, Verifizierung von Identitätsdokumenten oder die Korrektheit der eingereichten Nachweise.

