Lieferkomponenten ersetzen
Erforderliche Berechtigungen: deliveries:patch
Ersetzt alle Komponentenzuordnungen der Lieferung durch die übergebenen Gruppen.
Alle component_ids müssen zum Projekt der Lieferung gehören; innerhalb einer Gruppe müssen sie eindeutig sein.
Verteilungswerte müssen endliche, nicht negative Zahlen sein.
Gruppen, deren distribution leer ist oder nur Nullen enthält, werden ignoriert (wie in der Web-App).
Mit einem leeren Array groups werden alle Zuordnungen entfernt.
Übersicht
Ersetzt alle Komponentenzuordnungen der Lieferung durch den übergebenen Satz von Gruppen. Das entspricht dem Speichern der Komponentenübersicht in der Web-App: jede Gruppe bündelt mehrere Projektkomponenten (üblicherweise eine pro Komponententyp), die dieselbe Mengenverteilung auf die Lieferpositionen teilen.Berechtigungen
| Scope | Tenant-Typ |
|---|---|
deliveries:patch | Nur Kunden (CUSTOMER_ONLY) |
Anfragetext
| Feld | Typ | Beschreibung |
|---|---|---|
groups | array | Liste der Gruppen; [] entfernt alle Zuordnungen |
Pro Gruppe (groups[])
| Feld | Typ | Beschreibung |
|---|---|---|
component_ids | number[] | IDs der Projektkomponenten; mindestens ein Eintrag, innerhalb der Gruppe eindeutig |
distribution | object | Map von Positionsbezeichnung (title der Lieferposition) auf nicht negative endliche Menge |
Validierung und Verhalten
- Alle
component_idsmüssen zum Projekt der Lieferung gehören. - Verteilungswerte müssen endliche, nicht negative Zahlen sein.
- Gruppen mit leerer
distributionoder nur Nullwerten werden ignoriert (wie in der Web-App). - Die Antwort hat dieselbe Form wie GET
/deliveries/{id}/components(inkl. serverseitig vergebenergroup_idund angereicherter Komponentenmetadaten).
Response Codes
| Code | Beschreibung |
|---|---|
200 | Komponenten erfolgreich gesetzt; Body wie GET |
400 | Ungültiger Body oder Komponenten passen nicht zum Projekt |
403 | Keine Berechtigung — Lieferung gehört einem anderen Kunden |
404 | Lieferung nicht gefunden |
Autorisierungen
API-Schlüssel zur Authentifizierung. Kontaktieren Sie Ihren Customer Success Manager, um einen API-Schlüssel zu erhalten.
Jeder Endpunkt erfordert spezifische Berechtigungen (Scopes); die erforderlichen Scopes werden pro Endpunkt angezeigt.
Pfadparameter
Lieferungs-ID (UUID)
Body
Liste der Komponentengruppen; leeres Array entfernt alle Zuordnungen
Antwort
Komponentengruppen nach der Aktualisierung (gleiche Struktur wie GET)