Virksomhedshandlingerne synkroniserer godkendte profilfelter, mens Floral bevarer et stabilt virksomheds-id. Ved oprettelse med et dansk CVR kan Floral returnere den kanoniske virksomhed, der allerede findes i arbejdsområdet.
Forudsætninger
Du skal have contacts:read for at hente virksomheder og contacts:write for at oprette eller ændre dem. Metadata, brugerdefinerede felter, arkivering og gendannelse kræver også Work. Hent de tilgængelige virksomhedsfelter fra endpointet med feltdefinitioner, før du skriver customFields.
Angiv værdierne én gang i din shell, før du kører eksemplerne:
Brug en personlig adgangsnøgle, der er oprettet til arbejdsområdet. Eksemplerne bruger kunstige id’er og værdier. Erstat dem med værdier fra dit arbejdsområde.
Gem FLORAL_TOKEN i et hemmelighedslager uden for lokal udvikling. Læg det aldrig i kildekode eller logs.
Hent virksomheder
Virksomhedslisten bruger cursor-paginering. Som standard returneres aktive virksomheder sorteret efter seneste opdatering.
Send en nextCursor, der ikke er null, tilbage som cursor for at hente næste side. Undersøg eller konstruér ikke cursor-værdier.
Opret eller find en virksomhed
Opret en virksomhed med en unik idempotensnøgle. Når du medtager organizationNumber, kan Floral returnere arbejdsområdets kanoniske virksomhed med dette CVR i stedet for at oprette en dublet.
Et gennemført kald giver 201, en Location-header, en ETag og det fulde virksomhedssvar. Gem virksomhedens id og ETag.
Opdatér delvist
Hent virksomhedsdetaljen, og kopiér svarets ETag, før du ændrer den:
Send kun de felter, der skal ændres. Udeladte felter forbliver uændrede. En udtrykkelig null rydder et valgfrit profilfelt eller én brugerdefineret feltværdi.
Svaret indeholder en ny ETag. Erstat den gemte værdi før næste opdatering.
Arkivér og gendan
Arkivering er en ændring, der kan fortrydes. Den kræver både seneste ETag og en unik idempotensnøgle.
Gem arkiveringssvarets ETag. Gendan samme stabile virksomheds-id med værdien og en ny nøgle:
Floral beskytter skrivekald med to uigennemsigtige værdier:
- Send en unik
Idempotency-Key, når handlingen kræver det. Et identisk nyt forsøg med samme nøgle gentager resultatet i 24 timer. Hvis nøglen genbruges med et andet kanonisk input til samme handling, får du 409 IDEMPOTENCY_CONFLICT.
- Send den nyeste stærke
ETag som If-Match, når en eksisterende ressource ændres. En forældet værdi giver 412 VERSION_CONFLICT, og en manglende værdi giver 428 PRECONDITION_REQUIRED.
Behold anførselstegnene omkring en ETag, og erstat den gemte værdi efter hvert gennemført skrivekald. Se Driftssikkerhed og nye forsøg for alle regler om nye forsøg. 