Plean Tstála Réamh-Tháirgthe d'API Cuntasaíochta

Ní insíonn freagra 201 Created ó API cuntasaíochta aon rud beagnach. Dearbhaíonn sé gur thug an freastalaí freagra. Ní dhearbhaíonn sé go bhfuil sonrasc amháin ann go díreach, go bhfuil dochair cothrom le creidmheasanna, gur leithdháileadh uimhir an doiciméid uair amháin, ná nach n-áiritheoidh athsheoladh tar éis nasc a bheith caillte dara cóip. Tagann an chuid is mó de dhúblaigh chuntasaíochta táirgthe ón mbearna sin: athrú a tiomnaíodh ar an bhfreastalaí fad a bhí an cliant ina suí le toradh anaithnid agus a rinne athsheoladh go ciúin le eochair úr.

Tá an plean seo le haghaidh foirne atá ag measúnú API cuntasaíochta sula gcuireann siad i leabhair réadúla é. Dííríonn sé ar iompar teipe, ní ar chonairí ratha. Luaitear i ngach réimse thíos cad atá le tástáil, cad atá le dearbhú, agus cad a mheastar mar rath. Is é Nordlet comhthéacs cur chun feidhme anseo, a n-úsáideann a API eochair-iompróirí scóipeáilte (scoped bearer keys), méideanna teaghráin dheachúla (decimal-string amounts), eochracha dí-dhearbhachta (idempotency keys), agus gníomhartha gréasáin sínithe. Le haghaidh comhréir bheacht na gcríochphointí agus na gconarthaí freagartha, léigh na leathanaigh Coinbhinsiúin API agus Ag tús báire seachas brath ar thoimhdeanna.

Cad a chiallaíonn "pas" i ndáiríre

Ní chruthíonn tástáil go bhfuil comhtháthú cuntasaíochta sábháilte ach nuair a dheimhníonn sé séimeantaic, ní cóid stáit. Do gach cás, ba chóir don tsraith a dheimhniú:

• Iarmhairt ghnó: nach bhfuil ach custaiméir amháin, sonrasc amháin, iontráil irise amháin, leithdháileadh uimhreach amháin, nó aistriú íocaíochta amháin ann.
• Sláine chuntasaíochta: go bhfuil dochair cothrom le creidmheasanna, agus go mireann beachtas airgeadaíochta trí shraithú.
• Iompar athsheolta: go dtugann athsheoladh an toradh bunaidh ar ais seachas taifead nua.
• Marthanacht: go bhfuil taifid iniúchta agus imeachtaí gníomhartha gréasáin ann nuair a dhéantar an oibríocht a thiomnú.
• Teipeanna gan iarmhairt: nach n-itheann iarratais dhiúltaithe uimhreacha doiciméid agus nach scríobhann siad línte leabhair pháirteacha.
• Aisghabháil: gur féidir earráid shealadach a athsheoladh gan dúbláil ná caillteanas buan.

Tarraingíonn treoir API Google an líne go soiléir: níl ach oibríochtaí nach n-athraíonn a stát críochnaithe deiridh tar éis athsheoladh sábháilte le hathsheoladh, agus ba chóir d'API a aithint cé na hoibríochtaí atá dí-dhearbhach (idempotent) seachas gach teip a athsheoladh go dall.

Cuir timpeallacht indíolta, inbhreathnaithe ar bun

Úsáid cuideachta bhosca quainm (sandbox company), ní leabhair táirgthe. Úsáideann cuideachta bhosca quainm de chuid Nordlet na modúil agus an t-iompar API céanna le cuideachta réadúil agus tá sé marcáilte mar shonraí tástála, rud a fhágann go bhfuil sé sábháilte do thástálacha dúblacha agus teipe ard-tráchta. Tá an bhratach dothorthaithe tar éis a cruthaithe, mar sin ní féidir leabhair réadúla a athrangú mar shonraí tástála níos déanaí. Tabhair faoi deara go ndéantar tomhas agus billeáil ar úsáid bhosca quainm díreach cosúil le húsáid i gcuideachta réadúil, mar sin tomhais do thástálacha tráchta i gcoinne an phraghsála ar a bhfuil tú.

Sula scríobhann tú aon tástáil, ullmhaigh:

• Cuideachta bhosca quainm tiomnaithe le isSandbox: true.
• Eochair API tástála a scóipeáiltear go dtí na modúil faoi thástáil amháin.
• Críochphointe gníomhaíochta gréasáin nó tollán áitiúil a choinníonn coirp an iarratais amh.
• Custaiméirí, soláthraithe, agus cairt chuntais aitheanta síolta.
• Dhá thréimhse chuntasaíochta ar a laghad: ceann oscailte, ceann faoi ghlas.
• Clog tástála nó daingneán dáta má thacaíonn an cur chun feidhme leis.
• Stór áitiúil a thaifeadann gach iarracht iarratais, eochair dhí-dhearbhachta, hais freagartha, seachadadh gníomhaíochta gréasáin, agus toradh athmhuintearais.

Ná rith tástálacha dúblacha i gcoinne sonraí stáitse comhroinnte. Déanann custaiméir nó sonrasc strae ó rith a bhí roimhe seo dearbhuithe níos déanaí débhríoch.

Ba chóir do do dhaingneán do gach athrú an modh, an críochphointe, an comhlacht iomlán, an eochair dhí-dhearbhachta, scóip na heochrach, ID comhghaolaithe an chláraitheora, stampaí ama tús agus críochnaithe, stádas na freagartha, na ceanntásca, an comhlacht, ID an iarratais, agus cibé an raibh an nasc scortha sula ráinig an fhreagras a ghabháil. Úsáid teaghráin dheachúla socraithe amhail "75.0000" le haghaidh airgid. Léiríonn Nordlet luachanna airgeadaíochta mar theaghráin dheachúla le suas le ceithre áit dheachúla, agus úsáideann a shonrasc samplach an fhoirm sin.

Is é an leath eile den socrú ná instealladh teipe. Ba chóir go mbeadh do threalamh in ann freagras a chur siar, nasc TCP a scardadh tar éis don fhreastalaí an t-iarratas a fháil, freagraí sintéiseacha 429/500/502/503/504 a thabhairt ar ais, freagra neamh-2xx a thabhairt ar ais ón nglacadóir gníomhaíochta gréasáin, an ghníomhaíocht ghréasáin chéanna a sheachadadh faoi dhó, imeachtaí a athordú, beart amháin de chorp gníomhaíochta gréasáin a éilliú, pálasta eochrach dí-dhearbhachta a athrú agus an eochair á choinneáil, dhá iarratas comhionanna a rith go comhthráthach, agus tréimhse a ghlasáil idir socrú agus postáil. Is fiú níos mó ná céad sampla de chonair ratha na cásanna seo.

Glasáil an conradh sula scríobhann tú loighic athsheolta

Gin nó faigh an scéimre OpenAPI agus cuir i gcomparáid é le do chliant. Foilsíonn Nordlet a shonraíocht OpenAPI sa tagairt API agus gineann sé a SDKanna clóscríofa ón tsonraíocht chéanna sin, mar sin buaileann tástálacha atá tiomáinte ag scéimre le tuairimí lámhscríofa.

Deimhnigh na réimsí agus na cineálacha riachtanacha, réimsí teaghráin dheachúla, formáidí dáta agus stampa ama, gníomhartha agus scóip ceadaithe, cruth an imbhaill earráide, scéimreacha imeachtaí gníomhartha gréasáin, cé na hathruithe a ghlacann le eochair dhí-dhearbhachta, agus cé na réimsí freagartha a aithníonn an réad cruthaithe.

Critéir pasa. Diúltaíonn an cliant do phálastaí neamhbhailí go háitiúil i gcás ina gceadaíonn an scéimre. Tagann freagraí an fhreastalaí le an scéimre diciméadaithe. Táirgíonn deachúil neamhbhailí, dátaí olc, agus réimsí riachtanacha atá ar iarraidh earráidí bailíochtaithe struchtúrtha. Ní dhéantar aon iarratas ar athsheoladh le haghaidh teip bhailíochtaithe chinntithigh.

Mód teipe le gabháil. Déanann cliant "121.0000" a pharsáil i snámhán dénártha agus déanann sé méid beagán difriúil a shraithiú níos déanaí. Pasaíonn uimhreacha iomlána; teipeann ar línte CBL agus cainníochtaí codánacha. Tástáil an t-airgead mar theaghráin ó cheann go ceann.

Údarú agus aonrú tionóntaí

Úsáid eochracha ar leith le haghaidh léitheoireachta agus scríbhneoireachta. Ansin tástáil an greille iomlán: eochair ar iarraidh, eochair neamhbhailí, eochair bhailí le scóip modúil neamhleor, eochair bhailí leis an scóip cheart, eochair a bhaineann le cuideachta eile, agus iarratas ar réad ó chuideachta eile a léamh.

Dearbhuithe:

• Tugann dintiúir atá ar iarraidh nó neamhbhailí 401 ar ais.
• Tugann eochair bhailí gan an cead riachtanach 403 ar ais.
• Ní chruthaítear aon iarmhairt chuntasaíochta d'aon teip.
• Ní féidir le hiarratas rathúil taifid chuideachta eile a léamh ná a athrú.
• Ní dhéantar teipeanna slándála a athsheoladh go huathoibríoch riamh.

Critéir pasa. Is féidir leat ceartas údaraithe agus aonrú tionóntaí araon a chruthú le léamha i ndiaidh na tástála, ní hamháin le cóid stáit.

Cruthaigh idirbheart glan amháin

Rith sreabhadh beag cinntitheach: cruthaigh nó aimsigh custaiméir tástála, cruthaigh sonrasc le méideanna teaghráin dheachúla, eisigh é, léigh an sonrasc agus a éifeacht chuntasaíochta, léigh an taifead iniúchta, agus glac an ghníomhaíocht ghréasáin. Léiríonn sampla "Ag tús báire" de chuid Nordlet eisiúint sonrasc a leithdháileann uimhir gan bhearna, a sheiceálann go bhfuil an tréimhse oscailte, agus a phostálann iriseán cothrom san idirbheart céanna.

Dearbhaigh go sroicheann an sonrasc an stát a bhfuil súil leis, go leithdháiltear uimhir an doiciméid go díreach uair amháin, go bhfuil dochair cothrom le creidmheasanna, go dtagann CBL agus lán-suimeanna líne le ríomh leath-suas a bhfuil súil leis, go n-ainmníonn an taifead iniúchta an t-aisteoir agus an t-athrú, go seachadtar an ghníomhaíocht ghréasáin sa deireadh, agus go n-aontaíonn freagra an API agus léamh leantach ar ID agus ar stát an tsonraisc.

Idirdhealú amháin is fiú a choinneáil: ní dearbhú é gníomhaíocht ghréasáin a bheith ag teacht go bhfuil an t-athrú tiomanta. Is iad freagra an API móide léamh ar ais do phríomhdhearbhuithe idirbhirt. Cruthaíonn an ghníomhaíocht ghréasáin fógra iartheachtach, agus déantar tástáil uirthi ar leithligh.

Dí-dhearbhacht: an eochair chéanna, an corp céanna

Gin eochair amháin in aghaidh na hoibríochta gnó loighciúla, ní eochair amháin in aghaidh na hiarrachta líonra. Seol an t-athrú le eochair K agus corp B, sábháil an ID cruthaithe, ansin seol an t-iarratas céanna arís.

Dearbhaigh go léiríonn an dara freagra an oibríocht chéanna, go bhfuil ID an réad comhionann, agus go bhfuil aon réad gnó amháin, postáil amháin, uimhir doiciméid amháin, éifeacht airgeadais amháin ann. Ba chóir go iompródh an fhreagras athsheolta an ceanntásc athsheolta díchéimnithe — x-idempotent-replay: true i gcás Nordlet — agus ba chóir go léireodh an t-rian iniúchta nach raibh aon dara hathrú ann.

Athraíonn dhá riail stórála cad ba chóir do do lúb athsheolta a bheith ag súil leis, mar sin déan tástáil orthu go díreach: déantar 4xx stóráilte a athsheoladh cosúil le haon fhreagras eile, ach ní stóráiltear 5xx ar chor ar bith, mar sin déanann athsheoladh tar éis earráid freastalaí an oibríocht a athfheidhmiú seachas athsheoladh. Téann eochracha in éag freisin, i Nordlet tar éis 24 uair an chloig, rud a theorannaíonn cé chomh fada agus a bhíonn athsheoladh ar fáil.

Geallann doiciméadú Nordlet go gcuireann cur le ceanntásc Idempotency-Key cosc ar iarratas athsheolta dúblach a chruthú, agus sainiú comhbhinsiúin API an ceanntásc athsheolta beacht agus an riachtanas freagartha beart-le-beart. Tagann an prionsabal le model foilsithe Stripe: aithníonn eochair an oibríocht loighciúil, tugann athrá an toradh stóráilte ar ais, agus diúltaítear d’eochair a athúsáidtear le paraiméadair éagsúla seachas í a athrú go ciúin.

Critéir pasa. Níl ach aistriú stát airgeadais amháin ann is cuma cé mhéad uair a sheolann an cliant an t-iarratas céanna laistigh den fhuinneog athsheolta.

Dí-dhearbhacht: an eochair chéanna, corp athraithe

Seol an t-iarratas bunaidh le eochair K agus corp B1, ansin dara hiarratas le eochair K agus corp B2 i gcás ina bhfuil difríocht idir méid amháin ar a laghad, custaiméir, dáta, nó líne.

Toradh a bhfuil súil leis: diúltaítear don iarratas leis an earráid athúsáide eochrach díchéimnithe — tugann Nordlet 422 idempotency_key_reuse ar ais — fághtar an taifead bunaidh gan teagmháil, ní thagann aon dara taifead nó uimhir nó athrú iniúchta le feiceáil, agus ní "rannchuidíonn" an cliant le eochair nua a ghiniúint. Dá nglacfaí le B2 go ciúin, dhéanfaí eochracha athsheolta neamhshábháilte.

Iarratais dhúblacha comhtháthacha

Cuir biotáille ar dhá iarratas comhionanna leis an eochair chéanna ag an nóiméad céanna. Ag brath ar an iompar díchéimnithe, déanann ceann amháin feidhmiú fad a fhaigheann an ceann eile coimhlint atá ar siúl — tugann Nordlet 409 idempotency_in_progress ar ais — nó breathnaíonn an dá cheann ar an toradh céanna sa deireadh.

Dearbhaigh nach féidir leis an dá ghlao éifeachtaí airgeadais neamhspleácha a chruthú, nach leithdháiltear ach uimhir doiciméid amháin ar a mhéad, go ndéantar coimhlint shealadach a athsheoladh leis an eochair chéanna seachas le ceann nua, go bhfuil an acmhainn deiridh iomlán agus inléite, agus nach bhfanann an taifead dí-dhearbhachta i bhfostú go buan.

Mód teipe. Déanann leabharlann athsheolta a ghineann UUID úr in aghaidh na hiarrachta oibríocht loighciúil amháin a iompú ina roinnt scríbhinní neamhspleácha agus a chuireann isteach ar dhí-dhearbhacht go hiomlán.

An toradh a bhfuil neamhchinnteacht ag baint leis tar éis nasc a bheith scortha

Seo an tsamhail táirgthe aonair is tábhachtaí. Seol athrú le eochair K, lig don fhreastalaí é a thiomnú, scard an nasc sula dtagann an freagras, taifead an toradh mar anaithnid, ansin athsheol leis an eochair chéanna K agus déan athmhuintearas trí na sonraí acmhainne agus iniúchta a léamh.

Dearbhaigh go dtugann an t-athsheoladh an freagras athsheolta bunaidh nó díchéimnithe ar ais, go bhfuil iarmhairt airgeadais amháin ann go díreach, go marcálann an cliant an oibríocht críochnaithe ach amháin tar éis athsheoladh rathúil nó léamh athmhuintearais, agus nach ngintear eochair nua. Ní chiallaíonn teorainn ama "níor tharla aon rud". Sainiíonn Stripe an dí-dhearbhacht go beacht mar chosaint ar earráidí naisc i gcás inar phróiseáil an freastalaí athrú b'fhéidir sula raibh an cliant in ann an freagras a fháil.

Polasaí athsheolta choimeádach

Braitheann cinntí athsheolta ar an earráid agus ar cibé an bhfuil an oibríocht dí-dhearbhach araon, ní ar an modh HTTP amháin.

Inathsheolta de ghnáth, an eochair á coinneáil: athshocrú naisc nó teorainn ama tar éis athrú dí-dhearbhach, 408, 429 tar éis ómós a thabhairt do retry-after, agus 502/503/504. Is féidir freagras dí-dhearbhachta atá ar siúl agus atá díchéimnithe a athsheoladh tar éis moille gairid.

Neamh-inathsheolta gan athmhuintearas: earráidí bailíochtaithe 400/422, teipeanna fíordheimhnithe 401/403, 404 d’acmhainn ar iarraidh, coimhlintí gnó 409 nach mbaineann le eochair atá i gcroílár eitilte, pálasta athraithe ar eochair atá ann cheana, agus diúltú d'fhaireachas tréimhse.

Dearbhaigh cúlú easpónaiciúil teoranta le giotán, iarrachtaí uasta sainráite agus am caite, retry-after a urramú do theorainneacha ráta, an eochair chéanna a choinneáil thar athsheolta d'oibríocht amháin, eochair nua do gach oibríocht nua, agus loganna a scarann an iarracht bhunaidh ó athsheolta.

Tástáil teorannú ráta ar a shon féin. Trasnaigh an t-íosmhéid díchéimnithe — ceadaíonn Nordlet 300 iarratas in aghaidh an nóiméid in aghaidh na heochrach API de réir réamhshocraithe, agus tá a dteorainneacha níos ísle in aghaidh an seoladh ag roinnt críochphointí neamhfhíordheimhnithe — ansin deimhnigh go dtugann an freastalaí freagra an teorannaithe ráta ar ais, go ndéanann an cliant retry-after a pharsáil mar mhoill seachas mar earráid, go mbíonn sé ar sos seachas a bheith ag bualadh, agus go n-athúsáideann athsheoladh athraithe atá faoi smacht an eochair bhunaidh. Tuairiscíonn na ceanntásca x-ratelimit-* an buiséad atá fágtha, rud a dhéanann réamh-dhearbhú maith. Coinnigh tástálacha teorannaithe ráta ar shiúl ó dhearbhuithe airgeadais mura féidir le do dhaingneán iarracht a bhfuil smacht uirthi a insint ó cheann atá tiomanta.

Fíorú sínithe gníomhaíochta gréasáin

Tóg glacadóir a choinníonn na bearta amh. Do gach imeacht: gabh an corp amh, léigh an ceanntásc x-nordlet-signature, ríomh an HMAC-SHA256 a bhfuil súil leis leis an rúndiamhair síntiúis, cuir i gcomparáid ag baint úsáide as feidhm am-chomhsheasmhach, parsáil JSON amháin tar éis fíorúcháin, taifead an seachadadh, agus tabhair 2xx tapa ar ais tar éis glacadh marthanach. Síníonn Nordlet HMAC thar an gcorp amh, seolann sé é mar sha256=<hex>, agus déanann sé seachadtaí a athsheoladh le cúlú easpónaiciúil. Treisíonn treoir gníomhaíochta gréasáin Stripe an corp amh neamh-mhodhnaithe a fhíorú le comparáid am-chomhsheasmhach.

Rith tástálacha diúltacha: corp agus rúndiamhair cheart, corp ceart le rúndiamhair mhícheart, athrú coirp de bheart amháin, JSON ath-shraithetke le bánbhearnaí athraithe, ceanntásc ar iarraidh, sínithe millte, seachadadh seanda athsheolta má chuimsíonn an scéim stampa ama, agus sínithe bailí a seachadadh chuig an tsíniú mícheart.

Critéir pasa. Glactar leis an gcorp amh agus an rúndiamhair cheart amháin. Faigheann sínithe neamhbhailí neamh-2xx. Ní théann pálastaí neamhbhailí isteach sa scuaine chuntasaíochta riamh. Fanann rúndiamhair as loganna gnáthúla. Admhaíonn an láimhseálaí ach amháin tar éis an t-imeacht a bheith taifeadta go marthanach.

Gníomhartha gréasáin dúblacha agus as a n-ord

Fadhb ar leith is ea iontaofacht seachadta ó dhí-dhearbhacht API, agus caithfidh an glacadóir a bheith dí-dhearbhach freisin. Seachad an t-imeacht céanna faoi dhó, seachad imeacht sale_invoice.paid sula seachadtar imeacht sale_invoice.issued, tabhair 500 ar ais tar éis buanseasmhachta ach sula dtugtar freagra, agus athsheol imeacht a phróiseáil an tomhaltóir cheana féin.

Dearbhaigh nach ndéanann seachadtaí dúblacha íocaíochtaí, athruithe stáit, ná gníomhartha irise a dhúbláil, go n-úsáideann an eochair dhí-dhuibhithe seachadadh an tsoláthraí nó ID an imeachta nuair a bhíonn ceann ann (nó eochair chomhdhéanta díchéimnithe, ná habair stampa ama treallach), nach n-ionannaíonn imeachtaí as a n-ord stát níos nuaí le stát níos sine riamh, gur féidir leis an tomhaltóir an stát reatha a fháil ón API nuair nach leor ord, agus go ndéantar iarrachtaí tomhaltóra a theip a ródú trí scuaine nó cosán litreach marbh. Tugann Stripe rabhadh go soiléir nach bhfuil ráthaíocht ann d’ord seachadta agus molann sé IDanna imeachtaí próiseáilte a stóráil.

Coinnigh an críochphointe tanaí: bailíochtaigh an cruth, fíoraigh an sínithe, déan buanseasmhacht nó scuainigh, admhaigh, tabhair 2xx ar ais. Baineann athmhuintearas agus fógraí le próiseáil as-líne. Tástáil é tré obair iartheachtach a chur a chodladh thar theorainn ama an seachadta; admhaíonn glacadóir ceart fós tar éis scuainiú marthanach.

Tréimhsí cuntasaíochta oscailte agus faoi ghlas

Feidhmíonn Nordlet glasanna tréimhse ag am postála thar iriseáin lámhleabhair, sreabhadh doiciméad, agus allmhairí, mar sin déan tástáil ar an rialú i níos mó ná áit amháin. Cruthaigh doiciméid chomhionanna a bhfuil dáta orthu i dtréimhse oscailte, i dtréimhse faoi ghlas, ag an teorainn díreach sula ndéantar an glasáil, ar an gcéad lá den chéad tréimhse oscailte eile, agus le dáta doiciméid bailí ach dáta postála neamhbhailí má scarann an API an dá cheann.

I gcás na tréimhse faoi ghlas, dearbhaigh go ndiúltaítear don iarratas leis an earráid ghlais tréimhse díchéimnithe — 409 conflict in Nordlet — agus nach scríobhtar aon línte irise, nach n-itear aon uimhir doiciméid, nach n-aistrítear aon doiciméad go postáilte, agus nach lasann aon ghníomhaíocht ghréasáin ratha. Ba chóir go n-éireodh le leagan na tréimhse oscailte leis na luachanna airgeadais céanna.

Tástáil rása. Tosaigh postáil i gcoinne tréimhse oscailte, glasáil an tréimhse i lár an iarratais, agus deimhnigh nach féidir leis an tiomnú an glas a sheachaint. An phríomhchritéir pasa: ní thiteann postáil thiomanta i dtréimhse a bhí faoi ghlas sula dtionóntar an t-idirbheart.

Iniúchracht agus athmhuintearas

Do gach athrú rathúil, deimhnigh go bhfuil an réad gnó ann, go bhfuil an t-iontráil chuntasaíochta ann le dochair cothrom le creidmheasanna, go bhfuil an taifead iniúchta ann, go bhfuil an t-imeacht gníomhaíochta gréasáin ann nó go bhfuil sé inathfhaighte, agus go dtagraíonn do taifead oibríochta do ID an réad soláthraí le hathsheolta ag tagairt don oibríocht loighciúil chéanna.

Do gach athrú diúltaithe, deimhnigh nach bhfuil aon doiciméad páirteach ann, nár itheadh aon uimhir mura gceadaíonn an conradh áirithint, nach bhfuil aon iontráil leabhair ann, nach bhfuil aon ghníomhaíocht ghréasáin ratha ann, agus go n-iompraíonn an earráid ID iarratais le haghaidh diagnóisise. Déanann coinbhinsiúin Nordlet iniúchracht athraithe agus postálacha cothroma a chur síos mar ráthaíochtaí ardán, le cothromaíocht a fheidhmítear ag truicear bunachar sonraí i gcrích ag am tiomna seachas le cód feidhmchláir amháin. Déan na ráthaíochtaí sin a iompú ina gceisteanna athmhuintearais i ndiaidh na tástála seachas brath ar an bhfreagra HTTP.

Máistreacht tástála lárnach

Réimse	Gníomh tástála	Dearbhaíodh a bhfuil súil leis	Critéir pasa
Fíordheimhniú	Eochair ar iarraidh, eochair neamhbhailí, scóip neamhleor	401/403 struchtúrtha; gan iarmhairt	Ní chruthaíonn gach iarratas diúltaithe aon taifead cuntasaíochta
Scéimre agus airgead	Deachúil neamhbhailí, dáta, réimse riachtanach	Earráid bhailíochtaithe ag leibhéal réimse	Ní tharlaíonn aon athsheoladh ná scríbhneoireacht pháirteach
Postáil ghnáthach	Cruthaigh agus eisigh sonrasc i dtréimhse oscailte	Doiciméad amháin, iriseán cothrom amháin, taifead iniúchta amháin	Aontaíonn stát léite ar ais agus leabhar
Athsheoladh eochrach céanna	Athsheol athrú comhionann, an eochair agus an corp céanna	Toradh bunaidh athsheolta; gan dúbláil	Fanann ID réad, uimhir, éifeacht irise, iniúchadh uatha
Corp athraithe, an eochair chéanna	Athúsáid eochair le méid difriúil	Diúltú dathúsáide eochrach díchéimnithe	Taifead bunaidh gan athrú; níor scríobhadh aon rud nua
Nasc scortha	Tiomnaigh, scard, athsheol leis an eochair chéanna	Toradh athsheolta	Iarmhairt airgeadais amháin go díreach
Tréimhse faoi ghlas	Postáil doiciméad a bhfuil dáta air i dtréimhse faoi ghlas	Diúltú ghlais tréimhse	Gan iriseán, gan uimhir, gan ghníomhaíocht ghréasáin ratha
Sínithe gníomhaíochta gréasáin	Rúndiamhair mhícheart, corp athraithe	Neamh-2xx ón nglacadóir	Glactar leis an gcorp amh agus an rúndiamhair cheart amháin

Cad a dhéanfainn ar dtús

Má tá an t-am gairid, rith na tástálacha san ord a ghabhann na Fabhtanna is costasaí. Tosaigh leis an athsheoladh nasc scortha, toisc go dtáirgeann an cás singil sin an chuid is mó de na dúblaigh réadúla. Ansin an péire dí-dhearbhachta céanna-eochair agus athraithe-chorp. Ansin tréimhsí faoi ghlas, ós fadhb iniúchta í postáil i mí dhúnta a thagann chun cinn go déanach. Tagann fíorú sínithe agus gníomhartha gréasáin as a n-ord ina dhiaidh sin, agus is féidir leis an scéimre iomlán agus an greille údaraithe rith go leanúnach i CI nuair a dhéanann an cliant cobhsú.

Tacaíonn gach rud eile sa phlean seo leis an gcúigear sin. Faigh iad glas i gcoinne cuideachta bosca quainm, le léamha athmhuintearais ag deimhniú na n-iarmhairtí, agus beidh a fhios agat go bhfuil an comhtháthú sábháilte sula dtéann sé i dteagmháil le leabhar amháin fíor. Is féidir leat cuideachta bosca quainm agus eochair tástála scóipeáilte a chruthú i gcionn cúpla nóiméad ó Tosaigh, agus seiceáil cén modúil a dteastaíonn uait i gcoinne liosta na néanna.

FAQ

An leor freagra 2xx chun a dheimhniú gur éirigh le scríbhneoireacht cuntasaíochta?

Níl. Dearbhaíonn cód stáit gur thug an freastalaí freagra, ní go bhfuil sonrasc amháin, leithdháileadh uimhreach amháin, agus iontráil irise cothrom amháin ann. Ba chóir do gach tástáil athraithe leanúint den fhreagras le léamh ar ais den réad, a éifeacht chuntasaíochta, agus a taifead iniúchta. Is é an cás guaiseach an treo eile: oibríocht a tiomnaíodh fad nach bhfuair an cliant an freagras ar chor ar bith.

An cheart dom eochair dhí-dhearbhachta nua a ghiniúint nuair a bhíonn teorainn ama ag baint le hiarratas?

Níl, agus seo an botún is cúis leis an gcuid is mó de na dúblaigh táirgthe. Aithníonn an eochair an oibríocht ghnó loighciúil, ní an iarracht líonra. Athsheol an eochair chéanna, ansin déan athmhuintearas trí an acmhainn a léamh. Déanann leabharlann athsheolta a ghineann UUID úr in aghaidh na hiarrachta sonrasc beartaithe amháin a iompú ina roinnt scríbhinní neamhspleácha.

Cad a tharlaíonn má athúsáidim eochair dhí-dhearbhachta le pálasta difriúil?

Diúltaíonn API ceart dó seachas an corp nua a chur i bhfeidhm go ciúin. Tugann Nordlet 422 idempotency_key_reuse ar ais agus fágann sé an taifead bunaidh gan teagmháil. Ba chóir do do chliant é seo a chóireáil mar earráid raglamála le réiteach, ní mar choinníoll le hoibriú timpeall air trí eochair nua a ghiniúint.

An ionad iad gníomhartha gréasáin le haghaidh léamh ar ais den réad cruthaithe?

Níl. Cruthaíonn seachadadh gníomhaíochta gréasáin fógra iartheachtach, ní gur thiomnaigh an t-idirbheart an bealach a bhfuil súil agat leis, agus níl ráthaíocht ann d’ord seachadta. Fíoraigh an sínithe thar an gcorp amh, déan dí-dhuibiú ar an seachadadh nó ID an imeachta, agus faigh an stát reatha ón API nuair nach leor ord na n-imeachtaí ina aonar chun cinneadh a dhéanamh ar a athraigh.

Conas a dhéanaim tástáil ar phostáil i tréimhse chuntasaíochta faoi ghlas?

Cruthaigh doiciméid chomhionanna i dtréimhse oscailte agus i gceann faoi ghlas, agus dearbhaigh go ndiúltaítear don chás faoi ghlas gan aon línte irise, gan aon uimhir doiciméid ithe, gan aon aistriú stáit, agus gan aon ghníomhaíocht ghréasáin ratha. Ansin rith an leagan rása: tosaigh postáil i gcoinne tréimhse oscailte agus glasáil an tréimhse i lár an iarratais. Ní thiteann postáil thiomanta i dtréimhse a bhí faoi ghlas sula dtionóntar an t-idirbheart riamh.

An féidir liom tástálacha dúblacha ard-tráchta a rith i gcuideachta bosca quainm?

Is féidir. Iompraíonn cuideachta bosca quainm cosúil le ceann réadúil, tá sé marcáilte mar shonraí tástála, agus scriosann sé láithreach seachas tar éis na fuinneoige coinneála, mar sin is é an t-áit cheart é le haghaidh tástála millteach agus dúblach. Déantar tomhas agus billeáil ar úsáid bhosca quainm fós cosúil le húsáid réadúil, mar sin pleanáil an trácht seachas a bheith ag lúbáil gan teorainn.