އޮތެންޓިކޭޝަން

އެސްއެމްއެސްބީއޭޓީ ޗެޓްހަބް އެޕީއައި އިން ބޭނުންކުރަނީ ކުންފުނީގެ ޓޯކަންތަކާއި އޮޕަރޭޓަރ ޓޯކަންތަކާއެކު ދެ ލެވެލްގެ ޖޭޑަބްލިޔުޓީ ޓޯކަން އަށް ބިނާކޮށް އޮތެންޓިކޭޝަން ސިސްޓަމެކެވެ.

އޮތެންޓިކޭޝަން ފްލޯ

ކޯޑް_ބްލޮކް_0

ކުންފުނީގެ ޓޯކަން

ކުންފުނީގެ ޓޯކަންތަކުގެ ސަބަބުން ޗެޓްހަބް އެޕީއައި އަށް އޯގަނައިޒޭޝަން ލެވެލްގެ އެކްސެސް ލިބެ އެވެ.

ކުންފުނީގެ ޓޯކަން ހޯދުން

އެންޑްޕޮއިންޓް: POST /api/company/get-token

ރިކުއެސްޓް:

ކޯޑް_ބްލޮކް_1

ރިކުއެސްޓް ބޮޑީ:

ކޯޑް_ބްލޮކް_2

ޖަވާބު:

ކޯޑް_ބްލޮކް_3

އެ ޖަވާބަކީ ޖޭޑަބްލިޔުޓީ ޓޯކަން ސްޓްރިންގެކެވެ.

ކުންފުނީގެ ޓޯކަން ބޭނުންކުރުން

ދެ ގޮތުގެ ތެރެއިން އެއް ގޮތެއް ބޭނުންކޮށްގެން އެޕީއައި ރިކުއެސްޓްތަކުގައި ކުންފުނީގެ ޓޯކަން ހިމަނާށެވެ:

ގޮތް 1: އޮތޯރިޒޭޝަން ހެޑަރ (ރަނގަޅު)

ކޯޑް_ބްލޮކް_4

ގޮތް 2: އެކްސް-އޮތޮރައިޒޭޝަން-ކީ ހެޑަރ

ކޯޑް_ބްލޮކް_5

އޮޕަރޭޓަރ ޓޯކަން

އޮޕަރޭޓަރ ޓޯކަންސް އިން އޯގަނައިޒޭޝަނެއްގެ ތެރޭގައި ވަކިވަކި އޮޕަރޭޓަރުންނަށް ޔޫޒަރ ސްޕެސިފިކް އެކްސެސް ލިބިގެންދެއެވެ.

އޮޕަރޭޓަރ ޓޯކަން ހޯދުން

އެންޑްޕޮއިންޓް: POST /api/operator/get-token

ރިކުއެސްޓް:

ކޯޑް_ބްލޮކް_6

ރިކުއެސްޓް ބޮޑީ:

ކޯޑް_ބްލޮކް_7

ޕެރެމިޓަރސް:

ޕެރެމިޓަރ	ވައްތަރު	ބޭނުންވާ	ތަފްސީލު
`އައިޑީ`	އިންޓިޖަރ	އާދެ	އޮޕަރޭޓަރ އައިޑީ
`މުއްދަތު ހަމަވާ ވަގުތު`	ސްޓްރިންގް (އައިއެސްއޯ 8601)	އާދެ	ޓޯކަން މުއްދަތު ހަމަވާ ތާރީޚާއި ގަޑި (މިހާރުން ފެށިގެން ގިނަވެގެން 24 ގަޑިއިރު)

މުހިންމު: ޓޯކަންގެ އެންމެ ދިގު މުއްދަތަކީ 24 ގަޑިއިރު އެވެ. ކުރިއަށް އޮތްތަނުގައި expiresAt ޕެރެމިޓަރ 24 ގަޑިއިރަށްވުރެ ގިނައިރު ނުވާނެއެވެ.

ޖަވާބު:

ކޯޑް_ބްލޮކް_8

އޮޕަރޭޓަރ ޓޯކަން ބޭނުންކުރުން

އެޕީއައި ރިކުއެސްޓްތަކުގައި އޮޕަރޭޓަރ ޓޯކަން ހިމަނާށެވެ:

ކޯޑް_ބްލޮކް_9

ޓޯކަން ވެލިޑޭޝަން

ޓޯކަން ބޭނުން ކުރުމުގެ ކުރިން އަދިވެސް ސައްހަކަން ޔަގީންކުރުން.

އެންޑްޕޮއިންޓް: POST /api/operator/validate-token

ރިކުއެސްޓް:

ކޯޑް_ބްލޮކް_10

ރިކުއެސްޓް ބޮޑީ:

ކޯޑް_ބްލޮކް_11

ޖަވާބު (ސައްހަ ޓޯކަން):

ކޯޑް_ބްލޮކް_12

ޖަވާބު (ސައްހަ ނޫން ޓޯކަން):

ކޯޑް_ބްލޮކް_13

ޓޯކަން މުއްދަތު ހަމަވުން

ކުންފުނީގެ ޓޯކަންސް

އެޕީއައިގައި ސާފުކޮށް މުއްދަތު ހަމަނުވުން
ޓޯކަން ލައިފްސައިކަލް ޕޮލިސީތަކަށް އެކައުންޓް މެނޭޖަރާ ގުޅުން
ސެކިއުރިޓީއަށްޓަކައި ވަކިވަކިން ޓޯކަންތައް އެނބުރުވުން

އޮޕަރޭޓަރ ޓޯކަންސް

ޓޯކަން ރިކުއެސްޓް ކުރާއިރު މުއްދަތު ހަމަވުން ސެޓްކުރުން (expiresAt ޕެރެމިޓަރ)
ބޭނުން ކުރުމުގެ ކުރިން ޓޯކަންތައް ސައްހަކުރުން
މުއްދަތު ހަމަވުމުގެ ކުރިން އާ ޓޯކަން ހޯދުމަށް އެދި ހުށަހެޅުން

ތަންފީޒުކުރުމުގެ މިސާލުތައް

ޕައިތަން

ކޯޑް_ބްލޮކް_14

ޖާވާސްކްރިޕްޓް (Node.js)

ކޯޑް_ބްލޮކް_15

ޕީއެޗްޕީ

ކޯޑް_ބްލޮކް_16

އެންމެ ރަނގަޅު އުސޫލުތައް

ޓޯކަން ސްޓޯރޭޖް

✅ ޓޯކަންތައް ރައްކާތެރިކަމާއެކު ރައްކާކުރުން (އެންކްރިޕްޓް ކުރެވިފައިވާ ޑޭޓާބޭސް، ސިއްރުތައް މެނޭޖަރ)
✅ ދުވަހަކުވެސް ޓޯކަންސް ވަރޝަން ކޮންޓްރޯލަށް ކޮމިޓް ނުކުރުން
✅ ކްރެޑިޝަންތަކަށް އެންވަޔަރަންމަންޓް ވެރިއޭބަލްސް ބޭނުންކުރުން
❌ ޓޯކަންތައް ސާދާ ލިޔުމެއްގައި ރައްކާ ނުކުރުން
❌ ކްލައިންޓް ސައިޑް ކޯޑުގައި ޓޯކަންތައް ހާމަ ނުކުރުން

ޓޯކަން ރޮޓޭޝަން

ކުންފުނީގެ ޓޯކަންތައް ވަކިވަކިން (ކޮންމެ 3-6 މަހަކުން) އެނބުރުވުން
އޮޕަރޭޓަރ ޓޯކަންތަކަށް އެކަށީގެންވާ މުއްދަތު ހަމަވުން (7-30 ދުވަސް) ކަނޑައެޅުން
މުއްދަތު ހަމަވުމުގެ ކުރިން އޮޓޮމެޓިކް ޓޯކަން ރިފްރެޝް ތަންފީޒުކުރުން
އޮޕަރޭޓަރުން ފުރާއިރު ޓޯކަން ބާތިލްކުރުން

އެރަރ ހެންޑްލިންގ

ކޯޑް_ބްލޮކް_17

ޓޯކަން ވެލިޑޭޝަން

ކްރިޓިކަލް އޮޕަރޭޝަންތަކުގެ ކުރިން އަބަދުވެސް ޓޯކަންތައް ސައްހަކުރުން:

ކޯޑް_ބްލޮކް_18

ސަލާމަތަށް ވިސްނަންޖެހޭ ކަންތައްތައް

އެޗްޓީޓީޕީއެސް އެކަނި

އޮތެންޓިކޭޝަން ރިކުއެސްޓް ފޮނުވާއިރު އަބަދުވެސް އެޗްޓީޓީޕީއެސް ބޭނުންކުރުން:

ކޯޑް_ބްލޮކް_19

ޓޯކަން ސްކޯޕް

ކޮންމެ އޮޕަރޭޝަނަކަށް އެކަށީގެންވާ ޓޯކަން ބޭނުންކުރުން:

ކުންފުނީ ޓޯކަން: އޯގަނައިޒޭޝަން މެނޭޖްމަންޓް، އޮޕަރޭޓަރ އުފެއްދުން
އޮޕަރޭޓަރ ޓޯކަން: ޗެޓް އޮޕަރޭޝަންސް، މެސެޖް ހެންޑްލިންގ

ރޭޓް ލިމިޓްކުރުން

އޮތެންޓިކޭޝަން ރިކުއެސްޓްތަކަށް ރޭޓް ލިމިޓިންގ ތަންފީޒުކުރުން:

ކޯޑް_ބްލޮކް_20

މައްސަލަ ހައްލުކުރުން

401 ހުއްދަ ނެތް

ކްރެޑެންޝިއަލްސް ރަނގަޅުކަން ޔަގީންކުރުން
ޗެކް ޓޯކަން މުއްދަތު ހަމަނުވާކަން
ރިކުއެސްޓް ހެޑަރސްގައި ޓޯކަން ހިމެނޭކަން ޔަޤީންކުރުން
ޓޯކަން ފޯމެޓް ސައްހަކުރުން

403 ޙަރާމް

ޓޯކަންގައި ބޭނުންވާ ހުއްދަތައް ހުރިކަން ޔަގީންކުރުން
ރަނގަޅު ޓޯކަން ޓައިޕް ބޭނުންކުރާތޯ ބެލުން (ކުންފުނި އާއި އޮޕަރޭޓަރ)
ޓޯކަން ބާތިލްކޮށްފައި ނުވާކަން ޔަޤީންކުރުން

ޓޯކަން މުއްދަތު ހަމަވެއްޖެ

އާ ޓޯކަން ހޯދުމަށް އެދުމެވެ
އޮޓޮމެޓިކް ޓޯކަން ރިފްރެޝް ތަންފީޒުކުރުން
މުއްދަތު ހަމަވާންޖެހޭ އެކަށީގެންވާ ވަގުތުތައް ކަނޑައެޅުން

ދެން އަޅަންޖެހޭ ފިޔަވަޅުތައް

އޮގަނައިޒޭޝަންތައް - އޯގަނައިޒޭޝަންތައް ބެލެހެއްޓުން
އޮޕަރޭޓަރުން - އޮޕަރޭޓަރުންނާއެކު މަސައްކަތްކުރުން
ވިޖެޓް އިންޓަގްރޭޝަން - ޗެޓް ވިޖެޓް އިންޓަގްރޭޓްކުރުން