Fíordheimhniú leis an API
Tacaíonn GraphQL le dhá mhodh fíordheimhnithe:
| Mód | Clúdach | Ceannteideal | Is fearr do |
|---|---|---|---|
| SRP | Scéim iomlán GraphQL | Authorization: Bearer <access-token> | Comhtháthaithe iomlána |
| Eochair API | Fo-sraith tacaíochta amháin | Authorization: Bearer <api-key> | Uathoibriú taobh freastalaí agus sreafaí coitianta seolta/léite |
Is é SRP an modh fíordheimhnithe scéim-iomlán. Is féidir le heochracha API a cruthaíodh sa Phortail Forbróra rochtain a fháil ar fho-sraith tacaíochta d’oibriúcháin GraphQL.
Fíordheimhniú Eochair API
Cruthaigh eochair API atá cumasaithe le GraphQL sa Phortail Forbróra, ansin seol í mar thicéad bearer:
POST /graphql HTTP/1.1
Host: graphql.uk.legalesign.com
Content-Type: application/json
Authorization: Bearer ak_<environment>_<key-id>.<secret>
{"query": "{ user { id email } }"}
Seiceáil an tagairt GraphQL d’eochair API agus na bagaí údaraithe ar leathanaigh tagartha fiosrúcháin agus athruithe sular úsáide tú oibriú le eochair API.
Údarú Widget agus Comhpháirte
Teastaíonn ó widgets fíordheimhnithe, cosúil leis an Amharcóir Doiciméad agus Sínitheoir, ticéad a chuirtear chuig a airíonna token.
Tá dhá bhealach tacaíochta taobh freastalaí ann chun an ticéad sin a sholáthar:
| Foinse ticéid | Conas a oibríonn sé |
|---|---|
| JWT SRP | Úsáideann do fhreastalaí SRP chun ticéad rochtana JWT a fháil agus tugann sé an JWT sin don widget |
| Ticéad comhpháirte | Úsáideann do fhreastalaí eochair API chun glaoch a dhéanamh ar generateComponentToken, ansin tugann sé an token ar ais don widget |
Tá generateComponentToken ar fáil le heochair API amháin agus tugann sé ticéad sealadach do widgets. Fanaíonn SRP mar an rogha scéim-íomlán nuair ba cheart do do chúl-fhreastalaí JWT a sholáthar go díreach.
Féach Údarú Widget don sreabhadh iomlán ticéad comhpháirte agus na treoracha slándála brabhsálaí.
Fíordheimhniú SRP
Úsáid SRP nuair atá rochtain iomlán ag teastáil ort ar shcéim GraphQL.
Creidmheasanna API
Chun fíordheimhniú SRP a úsáid, déan teagmháil le tacaíocht Legalesign chun na creidmheasanna agus sonraí do do chomhtháite a fháil.