Diweddaru meysydd personol a ffenestri cynnal a chadw, rhedeg awtomeiddio ac ail-geisio ysgrifennu'n ddiogel.
Mae'r API a MCP yn cefnogi swyddi wedi'u rhestru, pŵer wedi'i drefnu, dad-drosi asiant, diagnosteg diweddbwynt, canslo gorchymyn a pholisïau patch trydydd parti. Ail-ddefnyddiwch allweddi idempotency ac archwiliwch dderbyniadau. Ceir credydau gweinyddwr dros dro unwaith. Mae monitro traffig yn gofyn am hawl sydd eisoes yn bodoli; mae bilio yn aros yn yr cais.
Gwirio eich caniatâd
Mae rhagosodiadau yn dewis galluoedd unigol; nid ydynt yn newid y lefel mynediad. Mae manylion mewngofnodi newydd yn y Gosodiadau yn defnyddio FullAccess yn ddiofyn, ond dim ond y galluoedd a ddewiswyd sy'n cael eu caniatáu. Mae manylion mewngofnodi ReadWrite hŷn yn caniatáu newidiadau maes personol a chynnal a chadw cymeradwy. Mae angen FullAccess ynghyd â'u galluoedd penodol ar awtomeiddio a rheoli dyfeisiau. Gwirio GET /v1/operations/capabilities cyn ysgrifennu. Mae cwmpas y cwmni a chaniatâd y perchennog presennol yn dal i fod yn berthnasol.
Osgoi trosysgrifo newid arall
Darllen y maes personol a'i fersiwn. Anfonwch eich gwerth newydd a'r fersiwn a ddarllenoch i PATCH /v1/custom-fields/{fieldId}. Mae A 409 version_conflict yn golygu bod rhywun wedi'i newid yn gyntaf. Darllenwch ef eto a phenderfynwch a yw eich diweddariad yn dal yn briodol.
Ceisiwch eto'n ddiogel
Ar gyfer POST /v1/maintenance-windows, anfonwch bennawd Idempotency-Key. Ar ôl canlyniad ansicr, ailadroddwch yr un allwedd a chorff i adfer y ffenestr wreiddiol yn hytrach na chreu dyblyg. Gwrthodir corff sydd wedi'i newid gyda'r un allwedd. Mae DELETE /v1/maintenance-windows/{windowId} yn canslo ffenestr.
Derbynebau gweithredu dilynol
Mae ysgrifennu awtomeiddio a rheoli yn defnyddio idempotencyKey yng nghorff JSON ac yn dychwelyd derbynneb gweithrediad. Mae Completed yn golygu bod y trinwr cais wedi gorffen; gwiriwch y canlyniad neu'r rhediad parth i ddysgu a yw'r ddyfais wedi gorffen y gwaith. Ar gyfer OutcomeUnknown, archwiliwch y dderbynneb a'r cyflwr cyfredol cyn penderfynu beth i'w wneud. Peidiwch byth ag ail-anfon yn awtomatig o dan allwedd newydd: gallai'r weithred redeg ddwywaith.