Skip to content

Fíordheimhniú

Úsáideann SMSBAT ChatHub API córas fíordheimhnithe dhá leibhéal JWT-bhunaithe le comharthaí cuideachta agus comharthaí oibreora.

Sreabhadh Fíordheimhnithe

_CÓD_BLOCK_0__

Chomhartha Cuideachta

Soláthraíonn comharthaí cuideachta rochtain ar leibhéal eagraíochta ar ChatHub API.

Faigh Comhartha Cuideachta

Críochphointe: POST /api/company/get-token

Iarratas:

_CÓD_BLOCK_1__

** Comhlacht Iarratas:**

_CÓD_BLOCK_2__

Freagra:

_CÓD_BLOCK_3__

Teaghrán comharthaí JWT is ea an freagra.

Úsáid Chomhartha Cuideachta

Cuir comhartha na cuideachta san áireamh in iarratais API ag baint úsáide as ceann amháin de dhá mhodh:

Modh 1: Ceanntásc Údaraithe (Molta)

_CÓD_BLOCK_4__

Modh 2: Ceanntásc X-Údarú-Eochair

_CÓD_BLOCK_5__

Chomhartha Oibreora

Soláthraíonn comharthaí oibreoirí rochtain shainiúil don úsáideoir d’oibreoirí aonair laistigh d’eagraíocht.

Faigh Comhartha Oibreora

Críochphointe: POST /api/operator/get-token

Iarratas:

_CÓD_BLOCK_6__

** Comhlacht Iarratas:**

_CÓD_BLOCK_7__

Paraiméadair:

Paraiméadar Cineál Ag Teastáil Cur Síos
id slánuimhir Tá Aitheantas Oibreora
éag At teaghrán (ISO 8601) Tá Dáta agus am éaga comhartha (24 uair ar a mhéad as seo)

Tábhachtach: Is é 24 uair an chloig uasshaolré comharthaí. Ní féidir leis an bparaiméadar expiresAt a bheith níos faide ná 24 uair sa todhchaí.

Freagra:

_CÓD_BLOCK_8__

Úsáid Chomhartha Oibreora

Cuir an comhartha oibreora san áireamh in iarratais API:

_CÓD_BLOCK_9__

Bailíochtú Comhartha

Deimhnigh go bhfuil comhartha fós bailí roimh é a úsáid.

Críochphointe: POST /api/operator/validate-token

Iarratas:

_CÓD_BLOCK_10__

** Comhlacht Iarratas:**

_CÓD_BLOCK_11__

Freagra (Comhartha Bailí):

_CÓD_BLOCK_12__

Freagra (Comhartha Neamhbhailí):

_CÓD_BLOCK_13__

Éaga Chomhartha

Comharthaí Cuideachta

  • Níl aon dul in éag follasach san API
  • Déan teagmháil le do bhainisteoir cuntais le haghaidh polasaithe saolré comharthacha
  • Rothlaigh comharthaí go tréimhsiúil le haghaidh slándála

Comharthaí Oibreora

  • Socraigh dul in éag nuair a iarrtar chomhartha (paraiméadar expiresAt)
  • Bailíochtaigh comharthaí roimh úsáid
  • Iarr comharthaí nua roimh dhul in éag

Samplaí Forfheidhmithe

Python

_CÓD_BLOCK_14__

JavaScript (Node.js)

_CÓD_BLOCK_15__

PHP

_CÓD_BLOCK_16__

Dea-Chleachtais

Stóráil Chomhartha

  • ✅ Stóráil comharthaí go slán (bunachar sonraí criptithe, bainisteoir rúin)
  • ✅ Ná tiomnaigh comharthaí riamh do rialú leagan
  • ✅ Úsáid athróga timpeallachta le haghaidh dintiúirí
  • ❌ Ná stóráil comharthaí i ngnáth-théacs
  • ❌ Ná nocht comharthaí i gcód taobh an chliaint

Rothlú Chomhartha

  • Rothlaigh comharthaí cuideachta go tréimhsiúil (gach 3-6 mhí)
  • Socraigh dul in éag réasúnta le haghaidh comharthaí oibreora (7-30 lá)
  • Athnuachan dearbhán uathoibríoch a chur i bhfeidhm roimh dhul in éag
  • Aisghairm comharthaí nuair a fhágann oibreoirí

Earráid á Láimhseáil

_CÓD_BLOCK_17__

Bailíochtú Comhartha

Bailíochtaigh comharthaí roimh oibríochtaí criticiúla i gcónaí:

_CÓD_BLOCK_18__

Cúrsaí Slándála

HTTPS amháin

Úsáid HTTPS i gcónaí agus iarratais fíordheimhnithe á seoladh agat:

_CÓD_BLOCK_19__

Scóip Chomhartha

Úsáid an comhartha cuí do gach oibríocht:

  • ** Chomhartha Cuideachta**: Bainistíocht eagraíochta, cruthú oibreoirí
  • ** Chomhartha Oibreora**: Oibríochtaí comhrá, láimhseáil teachtaireachtaí

Teorannú Ráta

Teorainn rátaí a chur i bhfeidhm le haghaidh iarratas fíordheimhnithe:

_CÓD_BLOCK_20__

Fabhtcheartú

401 Gan údar

  • Deimhnigh go bhfuil na dintiúir ceart
  • Níl an comhartha seiceála imithe in éag
  • A chinntiú go bhfuil comhartha san áireamh i gceanntásca iarratais
  • Bailíochtaigh formáid dearbhán

403 Toirmiscthe

  • Deimhnigh go bhfuil ceadanna ag teastáil ón chomhartha
  • Seiceáil an bhfuil an cineál ceart comharthaí á úsáid (cuideachta vs oibreoir)
  • Cinntigh nach bhfuil an comhartha cúlghairthe

Chomhartha in éag

  • Iarr comhartha nua
  • Athnuachan comhartha uathoibríoch a chur i bhfeidhm
  • Socraigh amanna éagtha cuí

Na Chéad Chéimeanna Eile