Referathandlingerne læser strukturerede møderesultater, erstatter hele det godkendte felt internalNotes og godkender et referat oprettet af kalderen, når det venter på godkendelse.
Forudsætninger
Du skal have meetings:read for at hente referater og meetings:write for at opdatere noter eller godkende et referat.
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 og filtrér referater
Referatlisten bruger uigennemsigtig cursor-paginering. Filtrér efter tilstand, virksomhed, mødetid eller evidensmålgruppe.
De understøttede tilstande er WAITING, WAITING_APPROVAL, APPROVED og FAILED. evidenceAudience er CUSTOMER eller INTERNAL. Send en nextCursor, der ikke er null, som næste sides cursor.
Hent referatet og dets version
Hent det aktuelle referat umiddelbart før en ændring. Kopiér ETag fra svarheaderen præcist, inklusive anførselstegn.
Behandl content som det strukturerede offentlige referat. Feltet kan være null, mens referatet ikke er klar.
Erstat interne noter
Den delvise opdatering accepterer kun internalNotes. En streng erstatter hele feltet, og null rydder det. Andre referatfelter afvises.
Gem den nye ETag fra svaret før godkendelse.
Godkend det aktuelle referat
Godkendelse kræver den nyeste ETag og en unik idempotensnøgle. Udelad det valgfrie input for at godkende den aktuelle mødetid og det strukturerede indhold.
Et gennemført svar har status APPROVED og indeholder en ny ETag. Godkendelse er kun gyldig for et referat oprettet af kalderen med status WAITING_APPROVAL. Andre tilstande giver 409 INVALID_STATE.
Hvis svaret afbrydes, sender du den identiske godkendelse igen med samme nøgle og version. Floral gentager det oprindelige resultat. Brug aldrig nøglen til et andet referat eller et ændret input.
Ryd interne noter
Genindlæs referatet for at hente den aktuelle ETag, og send derefter null:
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. 