Conas a oibríonn an API Baisce?
Le deireadhphointe an API Baisce, mar atá doiciméadaithe anseo, is féidir le húsáideoirí iarratais a chur isteach le haghaidh próiseáil bhaisce aisioncronach. Próiseálfaimid na hiarratais seo laistigh de 24 uair an chloig. Léifear sonraí gach iarratais ó chomhad réamhuaslódáilte, agus scríobhfar na freagraí chuig comhad aschuir. Is féidir leat an réad baisce a cheistiú le haghaidh nuashonruithe stádais agus torthaí.
Cad é praghsáil an API Baisce?
Cuirfear gach samhail ar fáil le lascaine costais 50% i gcomparáid leis na APIanna sioncronacha. Seo tuilleadh eolais faoi phraghsáil ár n-API.
Cé na samhlacha is féidir liom a úsáid i mbaisc?
Tá an API Baisce ar fáil go forleathan ar fhormhór ár samhlacha, ach ní ar gach ceann acu. Féach ar na doiciméid tagartha samhlacha lena chinntiú go dtacaíonn an tsamhail atá á húsáid agat leis an API Baisce.
Cad a tharlaíonn mura gcuireann an API m’iarratas i gcrích laistigh den am a gealladh?
Tá sé mar aidhm againn gach iarratas a chur i gcrích laistigh de 24 uair an chloig. Má théann baisc in éag (is é sin, murarbh fhéidir í a chur i gcrích laistigh de thréimhse ama an SLA), cuirtear an obair atá fágtha ar ceal agus seoltar ar ais aon obair atá curtha i gcrích cheana féin. Gearrfar táille ar fhorbróirí as aon obair atá curtha i gcrích.
Cad é an teorainn ar líon na n-iarratas is féidir liom a bhaisceáil?
Tá teorainn 1 mhilliún iarratas i scuaine ag aon am amháin ar APIanna leabúchán.
Maidir le gach API eile, níl aon teorainn ar líon na n-iarratas is féidir leat a bhaisceáil; áfach, tá teorainn ráta bhaisce ghaolmhar ag gach sraith úsáide. Cuimsíonn do theorainn ráta bhaisce uaslíon na dtéacschomharthaí ionchuir atá curtha i scuaine agat ag aon am amháin. Is féidir leat do theorainneacha ráta a fháil anseo.
An féidir liom an t-am a thógann sé freagra a fháil ón API Baisce a athrú?
Is é 24 uair an chloig an fhuinneog ama atá sonraithe againn faoi láthair. Ní féidir linn an tréimhse ama seo a athrú faoi láthair.
An dtacaítear le sruthú ar an API Baisce?
Ní thacaítear le sruthú ar an API Baisce. Filleann iarratais bhaisce torthaí trí chomhaid aschuir seachas trí fhreagraí sruthaithe.
An dtacaítear le híomhánna ar an API Baisce?
Sea, tacaítear le híomhánna ar an API Baisce.
Fuair mé teachtaireacht earráide “Ní mheaitseálann an URL a cuireadh ar fáil don iarratas seo réimír dheireadhphointe na baisce”. Cad ba cheart dom a dhéanamh?
Má fhaigheann tú an earráid seo, ciallaíonn sé go bhfuil do URL formáidithe go mícheart do dheireadhphointe an API Baisce. Féach ar ár ndoiciméadú anseo lena chinntiú go bhfuil tú ag glaoch ar an deireadhphointe i gceart.
An áirítear úsáid an API Baisce i gcoinne mo theorainneacha ráta eile?
Tá teorainneacha ráta an API Baisce go hiomlán ar leith ó na teorainneacha atá ann cheana.
Cad a tharlaíonn má chuirtear baisc ar ceal?
Má chuirtear baisc ar ceal de láimh, seoltar ar ais na torthaí uile atá curtha i gcrích cheana féin. Gearrfar táille ar fhorbróirí as aon obair atá curtha i gcrích.
Cad a tharlaíonn má théann baisc in éag?
Má théann baisc in éag (is é sin, murarbh fhéidir í a chur i gcrích laistigh de thréimhse ama an SLA), cuirtear an obair atá fágtha ar ceal agus seoltar ar ais aon obair atá curtha i gcrích cheana féin. Gearrfar táille ar fhorbróirí as aon obair atá curtha i gcrích.
Cé na stádais is féidir liom a bheith ag súil leo do jabanna baisce?
Is féidir le haon cheann de na stádais seo a leanas a bheith ag an jab baisce: Á bhailíochtú, Teipthe, Ar siúl, Á thabhairt chun críche, Críochnaithe, Éagtha, Á chealú, agus Cealaithe. Má tá luachanna stádais API á seiceáil agat go ríomhchláraithe, úsáid na litéarálacha i gcás íochtair: validating, failed, in_progress, finalizing, completed, expired, cancelling, agus cancelled.
Á bhailíochtú: Tá bailíochtú an chomhaid uaslódáilte ar siúl sular féidir leis an mbaisc tosú.
Teipthe: Theip ar an gcomhad sa phróiseas bailíochtaithe.
Ar siúl: Bailíochtaíodh an comhad go rathúil agus tá an próiseas baisce ar bun.
Á thabhairt chun críche: Tá an jab baisce críochnaithe agus tá na torthaí á n-ullmhú.
Críochnaithe: Tá an jab baisce críochnaithe agus tá na torthaí réidh.
Éagtha: Níorbh fhéidir an bhaisc a chríochnú laistigh d'fhuinneog ama an SLA.
Á chealú: Cuireadh tús le cealú an jab baisce.
Cealaithe: Cuireadh an jab baisce ar ceal.
Conas is féidir liom a sheiceáil cé na jabanna baisce atá cruthaithe agam cheana?
Is féidir leat liosta de do jabanna baisce uile a fháil leis an nglao API atá sonraithe anseo.
An dtacaítear le gan coinneáil sonraí ar an deireadhphointe seo?
Má tá gan coinneáil sonraí cumasaithe agat do d'eagraíocht, tabhair faoi deara nach mbaineann gan coinneáil sonraí leis an API Baisce. Is féidir le heagraíochtaí ZDR jabanna baisce a chruthú, ach coinnítear comhaid ionchuir baisce, aschuir, earráidí agus déantáin idirmheánacha de réir na mbeartas coinneála cumraithe do Batch, File Service agus Sediment.