Cóid Earráide

Agus tú ag idirghníomhú leis an API SMSBAT, seans go dtiocfaidh earráidí ort. Bainimid úsáid as gnáthchóid freagartha HTTP chun rath nó teip ar iarratas API a léiriú.

Go ginearálta:

• Léiríonn cóid sa raon 2xx rathúlacht.
• Léiríonn cóid sa raon 4xx earráid a theip i bhfianaise na faisnéise a soláthraíodh (m.sh., fágadh paraiméadar riachtanach ar lár, tá cineál teachtaireachta neamhbhailí, etc.).
• Léiríonn cóid sa raon 5xx earráid lenár bhfreastalaithe.

Cóid Stádais HTTP

Cód	Stádas	Cur Síos
200	ceart go leor	D’éirigh leis an iarratas.
400	Drochiarratas	Bhí an t-iarratas do-ghlactha, go minic mar gheall ar pharaiméadar riachtanach a bheith in easnamh nó JSON míchumtha.
401	Neamhúdaraithe	Níor soláthraíodh eochair API bailí, nó níor éirigh leis an bhfíordheimhniú.
403	Toirmiscthe	Níl cead ag an eochair API an t-iarratas a dhéanamh, nó tá do chuntas ar fionraí.
404	Gan Aimsiú	Níl an acmhainn iarrtha ann.
415	Cineál Meán Gan Thacaíocht	Tá an ceanntásc Content-Type in easnamh nó níl sé socraithe mar iarratas/json.
422	Aonán Neamhphróiseáilte	Formáidíodh an t-iarratas i gceart ach bhí earráidí shéimeantacha ann (m.sh. formáid uimhir theileafóin neamhbhailí).
429	An Iomarca Iarratas	Bhuail an iomarca iarratas an API ró-thapa. Molaimid do chuid iarrataí a chúlú go heaspónantúil.
500, 502, 503, 504	Earráidí Freastalaí	Chuaigh rud éigin mícheart ar deireadh SMSBAT.

Formáid Freagartha Earráide

Nuair a bhíonn earráid mar thoradh ar iarratas API, tá oibiacht JSON sa chomhlacht freagartha le tuilleadh sonraí faoin bhfadhb.

CÓD_BLOCK_0_

Cóid Earráide Loighic Ghnó (Cóid Inmheánacha)

Chomh maith le cóid stádais HTTP, féadfaimid cód inmheánach sonrach a thabhairt ar ais chun cabhrú leat an chúis bheacht leis an teip a aithint.

Cód Inmheánach	Cur Síos	Gníomh Molta
1001	Formáid Iarratais Neamhbhailí	Cinntigh gur JSON bailí do chomhlacht iarratais.
1002	Réimse Riachtanach ar Iarraidh	Seiceáil an t-airí `teachtaireacht’ sa fhreagra le fáil amach cén réimse atá in easnamh.
1003	Uimhir Theileafóin Neamhbhailí	Cinntigh go bhfuil uimhir an fhaighteora san fhormáid E.164 (m.sh., 380501234567).
1004	Ainm Alfa Neamhchláraithe	Tá ainm alfa nach bhfuil ceadaithe do do chuntas sa pharaiméadar ó.
1005	Iarmhéid Neamhleor	Níl go leor airgid ag do chuntas chun an feachtas teachtaireachtaí a phróiseáil.
1006	Cineál Neamhbhailí Teachtaireachta	Caithfidh an paraiméadar cineál a bheith mar cheann de na cineálacha a dtacaítear leo (m.sh., sms, viber_promo).
1007	Teimpléad Gan Aimsiú	Tá an t-aitheantas teimpléid Viber/OTP a iarradh neamhbhailí nó níl sé ceadaithe.
1008	Míreanna Timpealláin Neamhbhailí	Caithfidh idir 2 agus 5 mhír a bheith i Timpeallán Viber.

[!TIP] Má thagann tú ar chód earráide nach bhfuil liostaithe anseo, nó má chreideann tú gur cuireadh earráid ar ais trí dhearmad, déan teagmháil le do thoil le [email protected] agus tabhair an t-ualach pá freagartha cruinn agus na ceanntásca.