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
- Eagraíochtaí - Bainistigh eagraíochtaí
- Oibreoirí - Oibriú le hoibreoirí
- Comhtháthú Giuirléid - Comhtháthaigh an ghiuirléid chomhrá