Tagrannán API.
Críonna API phoiblí le haghaidh forbraitheoirí: Foirmleoirí, vídiúcháin, cumadóir táirgí agus níos mó.
Ní dhéanann an tagairt seo cur síos ach ar chríochphointí JSON fíora atá ar fáil go poiblí -- modh, conair, cineál fíordheimhnithe, paraiméadair éigeantacha, sampla d'iarratas agus de fhreagra, agus na cóid earráide doiciméadaithe do gach críochphointe. Níl córas ginearálta eochracha API d'fhorbróirí ag Zentor; ag brath ar an mbealach, bíonn rochtain ann gan fíordheimhniú nó trí chomhartha leabaithe giuirléide le seiceáil Origin. D'aon ghnó ní chuimsítear bealaí inmheánacha an phainéil ná críochphointí Master Admin sa tagairt phoiblí seo, mar ní féidir iad a rochtain ach trí sheisiún logáilte isteach rialta.
Tá nóta tástála beo ag gach iontráil críochphointe a léiríonn cé acu an as scéimre na clárlainne, as tástáil uathoibrithe nó as fíorbhreathnóireacht bheo a thagann an fhaisnéis -- ní mheastar gur cruthúnas iomlán é cosúlacht amháin le conair chóid a oibríonn. Ina theannta sin, ní dheimhníonn glao atá rathúil go teicniúil ach gur próiseáladh an t-iarratas féin, ní próisis níos faide anonn go huathoibríoch, amhail seachadadh ríomhphoist, críochnú íocaíochta nó logáil isteach SSO críochnaithe.
Braitheann an chosaint ar an ngrúpa. Ní theastaíonn seisiún painéil ó chríochphointí poiblí dlí, margaíochta agus foirmeacha. Úsáideann an ghiuirléid chomhrá, ar an láimh eile, an ceanntásc `X-Widget-Token` agus liosta ceadaithe Origin. Tugann logálacha isteach an phainéil JWT seisiúin a mhaireann dhá uair déag agus comhartha athnuachana atá bailí ar feadh seacht lá. Oibríonn críochphointí SSO lena gcóid aonuaire agus a sreafaí aisghlao féin.
Léigh gach leathanach críochphointe mar chonradh neamhspleách. Is iad modh HTTP, conair, paraiméadair éigeantacha, cineálacha sonraí, corp an iarratais, struchtúr an fhreagra, cóid earráide agus neamhathraitheacht (idempotency) atá cinntitheach. Léiríonn sampla formáid fhéideartha, ach ní ionann é agus seiceáil a dhéanamh ar an bhfreagra iarbhír. Is féidir le stádas cumraíochta, bailíochtuithe, ceadanna agus soláthraithe seachtracha an toradh a athrú.
Is é an teorainn ráta deimhnithe ar fud an ardáin ná 2,000 iarratas laistigh de 15 nóiméad. Níl teorainneacha ar leith do gach críochphointe doiciméadaithe go comhsheasmhach. Níor cheart do chliaint, mar sin, lúba vótaíochta (polling) atá ró-dhlúth gan ghá a úsáid. I gcás oibríochtaí nach bhfuil neamhathraitheach, is féidir le hathiarrachtaí uathoibríocha taifid nó teachtaireachtaí dúblacha a chruthú.
Ní ceart luachanna íogaire a chur i logaí. Áirítear orthu sin pasfhocail, comharthaí athshocraithe, cóid fíoraithe, comharthaí giuirléide, aitheantais seisiúin agus fíorshonraí pearsanta samplacha. Úsáid luachanna gan ainm i ndoiciméadú agus i dtástálacha. Caithfidh nótaí tástála beo an fíorchruthúnas a léiriú go cruinn.