Çelësat dhe webhook-ët
Kredencialet dhe endpoint-et që ka lëshuar kjo hapësirë pune.
Veglat e çelësave dhe webhook-ëve
| Vegla | Çfarë bën |
|---|---|
| listApiKeys | Çdo çelës API që ka lëshuar kjo hapësirë pune, çfarë mund të bëjë dhe si mund të dërgojë, në një formë të maskuar që mjafton për të dalluar dy çelësa nga njëri-tjetri dhe asgjë më shumë. |
| rotateApiKey | Jepini një çelësi një sekret të ri, duke ruajtur id-në, emrin, scope-et, rolin dhe scope-in e dërgimit. Nuk ka dritare mbivendosjeje, dhe sekreti i ri shfaqet një herë të vetme. |
| setApiKeyEnabled | Fikni një çelës, ose ndizeni sërish. Ky është i kthyeshmi: çelësi ruan sekretin, scope-et, rolin dhe scope-in e dërgimit. |
| revokeApiKey | Revokoni një çelës përgjithmonë. Një çelës i revokuar nuk mund të ndizet, të rrotullohet ose të ndryshohet më kurrë. |
| setApiKeySendScope | Thoni si cilat adresa mund të dërgojë një çelës, si dy lista të pavarura. Ajo që kaloni ZËVENDËSON atë që kishte çelësi. |
| listWebhooks | Çdo endpoint webhook që ka kjo hapësirë pune, ku dërgon, nëse është i aktivizuar dhe cilat evente kërkoi. Sekretet e nënshkrimit nuk shfaqen kurrë. |
| listWebhookEvents | Çdo event në të cilin mund të abonohet një endpoint, i grupuar sipas familjes, me një rresht që thotë kur aktivizohet secili. |
Një sekret shfaqet një herë, kur çelësi krijohet ose rrotullohet, dhe asgjë nuk e rikthen më pas. rotateApiKey është e vetmja vegël këtu që kthen një të tillë, kështu që çfarëdo që mban sekretin e vjetër duhet t'i jepet zëvendësimi para se të ekzekutohet sërish.
Kapni setApiKeyEnabled para revokeApiKey. Fikja e një çelësi është e kthyeshme dhe ju tregon nëse ende varet diçka prej tij; revokimi është i përhershëm dhe rruga e vetme përpara prej tij është një çelës i ri dhe një sekret i ri.
Nuk ka createApiKey dhe as createWebhook këtu, për të njëjtën arsye pse nuk ka createRole: lëshimi i një kredenciali nga brenda një dritareje bisede është një ndryshim i heshtur e i gjerë që askush nuk e sheh më pas. Të dyja janë te Cilësimet, ku kushdo që e bën mund të shohë çfarë po shpërndan.