Bis zu 500 Portfolio-Zeilen bereitstellen
Speichert einen strikt validierten Stapel nur im unsichtbaren Staging-Bereich. Jeder Stapel enthaelt 1 bis 500 Zeilen und hoechstens 512 KiB. Nach UID- und UTC-Normalisierung inhaltlich gleiche external_id-Zeilen im selben Lauf sind idempotente Wiederholungen; sie erhoehen received_items nicht. Widerspruechlicher Inhalt fuer dieselbe external_id ergibt 409 und der ganze Stapel bleibt unveraendert. Auch eine formal gueltige, aber im verifizierten Registerbestand unbekannte UID verwirft den ganzen Stapel. replace akzeptiert ausschliesslich upsert; delta akzeptiert upsert und delete. Ein reiner delete-Stapel benoetigt keinen Register-Lesezugriff. In Summe duerfen nie mehr eindeutige IDs gespeichert werden als expected_items. Der Rumpf ist unkomprimiertes UTF-8-JSON. Nach jedem HTTP-5xx ist derselbe Stapel sicher wiederholbar.
Request
- Base URL: https://firmenwatch.ch/api/v1
- URL: https://firmenwatch.ch/api/v1/portfolios/{sourceKey}/syncs/{syncId}/items
- Auth: HTTP bearer
Path parameters
Dauerhafter, kontoeigener Quellenschluessel. Kleingeschrieben und URL-stabil; dieselbe Quelle muss bei jedem Lauf denselben Wert verwenden.
Vom Client vergebene, innerhalb der Quelle stabile Laufkennung.
Request body
Response
Atomar angenommener Stapel samt eindeutigem Fortschritt.
Changes
No recorded changes to this operation across all 1 revision of this API.