އޮޕަރޭޓަރ އޮތޯރިޒޭޝަން އަދި ޑީޕް ލިންކްސް

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

އެޕީއައި ބޭސް ޔޫއާރްއެލް: https://chatapi.smsbat.com/ ސްވެގަރ: https://chatapi.smsbat.com/index.html

ނޯޓް: ކުންފުނީގެ ފެންވަރުގެ ރިކުއެސްޓްތަކަށް ބެއަރ އޮތޯރިޒޭޝަންގެ ބަދަލުގައި ތިބާގެ ޓޯކަން (ޑޭޝްބޯޑްގައި ތިބާގެ ޕްރޮފައިލްގައި ހުންނަ) އާއި އެކު X-Authorization-Key ހެޑަރ ބޭނުންކުރެވިދާނެއެވެ.

---

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

ކުންފުނީގެ ޓޯކަން ހޯދުމަށްޓަކައި، ކުންފުނީގެ ލޮގިން ކްރެޑެންޝިއަލްސް ހިމެނޭ /api/company/get-token އަށް އެޗްޓީޓީޕީ ޕޯސްޓް ރިކުއެސްޓެއް ފޮނުވުން.

ރިކުއެސްޓް

• ގޮތް: ޕޯސްޓް
• ޔޫއާރްއެލް: https://chatapi.smsbat.com/api/company/get-token
• ހެޑަރސް: ކޮންޓެންޓް-ޓައިޕް: އެޕްލިކޭޝަން/ޖޭއެސްއޯއެން

ހަށިގަނޑު: ކޯޑް_ބްލޮކް_0

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު: ސްޓްރިންގް ޓޯކަން ("ތިބާ_ޓޯކަން_ސްޓްރިންގް")

ނޯޓް: ލިބުނު ޓޯކަން ފަހުން ކުރާ ރިކުއެސްޓްތަކަށް ސޭވް ކުރާށެވެ.

---

2. އޯގަނައިޒޭޝަން ލިސްޓް ހޯދުން

ތިމާގެ އޯގަނައިޒޭޝަންތައް ލިސްޓް ކުރުމަށް ކުންފުނީގެ ޓޯކަން ބޭނުންކޮށްގެން /api/company/organization އަށް ޖީއީޓީ ރިކުއެސްޓެއް ފޮނުވުން.

ރިކުއެސްޓް

• ގޮތް: ގެޓް
• ޔޫއާރްއެލް: https://chatapi.smsbat.com/api/ކުންފުނި/އޮގަނައިޒޭޝަން
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ގަބޫލުކުރުން: ލިޔުން/ސާދާ

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު: ކޯޑް_ބްލޮކް_1

---

3. އޯގަނައިޒޭޝަންގެ ގޮތުގައި އޮޕަރޭޓަރުން ހޯދުން

organizationId ޕެރެމިޓަރ ބޭނުންކޮށްގެން /api/operator އަށް GET ރިކުއެސްޓެއް ފޮނުވުން.

ރިކުއެސްޓް

• ގޮތް: ގެޓް
• URL: https://chatapi.smsbat.com/api/އޮޕަރޭޓަރ؟އޮގަނައިޒޭޝަންއައިޑީ={އައިޑީ}
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ގަބޫލުކުރުން: ލިޔުން/ސާދާ

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު: ކޯޑް_ބްލޮކް_2

---

4. ސިސްޓަމަށް އޮޕަރޭޓަރުން އިތުރުކުރުން

މި އެންޑްޕޮއިންޓަށް ވަދެ، އޮޕަރޭޓަރުން ސިސްޓަމަށް ސިންކްރޮނައިޒް ކުރުމަށް ކުންފުނީގެ ޓޯކަން ބޭނުންކުރުން.

ރިކުއެސްޓް

• ގޮތް: ޕޯސްޓް
• URL: https://chatapi.smsbat.com/api/އޮޕަރޭޓަރ/ސިންކްރޮނައިޒް
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ކޮންޓެންޓް-ޓައިޕް: އެޕްލިކޭޝަން/ޖޭއެސްއޯއެން

ހަށިގަނޑު: ކޯޑް_ބްލޮކް_3

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު: ކޯޑް_ބްލޮކް_4

ޕޮސިބިލް އޮޕަރޭޓަރ ސްޓޭޓަސްސް:

• އެކްޓިވް: 0
• އިންއެކްޓިވް: 1
• ޑިލީޓްކޮށްފައިވަނީ: 2

---

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

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

ރިކުއެސްޓް

• ގޮތް: ޕޯސްޓް
• ޔޫއާރްއެލް: https://chatapi.smsbat.com/api/operator/get-token
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ކޮންޓެންޓް-ޓައިޕް: އެޕްލިކޭޝަން/ޖޭއެސްއޯއެން

ހަށިގަނޑު: ކޯޑް_ބްލޮކް_5 expiresAt ބޭނުންވާއިރު، އޮޕަރޭޓަރުގެ ސެޝަން މުއްދަތު (މެކްސް +24 ގަޑިއިރު) ކަނޑައަޅައެވެ.

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު: ސްޓްރިންގް ޓޯކަން

---

6. އޮޕަރޭޓަރ ޓޯކަން ސައްހަކުރުން

އޮޕަރޭޓަރެއްގެ ޓޯކަންގެ ސައްހަކަން ޔަގީންކުރުން.

ރިކުއެސްޓް

• ގޮތް: ޕޯސްޓް
• URL: https://chatapi.smsbat.com/api/އޮޕަރޭޓަރ/ވެލިޑޭޓް-ޓޯކަން
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ކޮންޓެންޓް-ޓައިޕް: އެޕްލިކޭޝަން/ޖޭއެސްއޯއެން

ބޮޑީ: "އޮޕަރޭޓަރ_ޓޯކަން_ސްޓްރިންގް"

ސައްހަ ޖަވާބު (200 އޯކޭ): ކޯޑް_ބްލޮކް_6

---

7. އޮޕަރޭޓަރ ޗެޓް ޕެނަލް އަށް ޑީޕް ލިންކް ކުރުން

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

ފޯމެޓް 1: ޗެޓް އައިޑީ އިން

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

ފޯމެޓް 2: ފޯނު ނަންބަރުން

ކޯޑް_ބްލޮކް_8 ފޯނު ނަންބަރު އީ.164 އިންޓަނޭޝަނަލް ފޯމެޓުގައި ހުންނަންވާނެއެވެ.

ފޯމެޓް 3: އަލްފާ ނަމާއި ފޯނުން

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

ފޯމެޓް 4: ފުރިހަމަ ޓާގެޓް ޑީޓެއިލްސް

މެސެޖުތައް އިންޓަސެޕްޓް ކުރަންވީ ސީދާ ކޮން ސޯސްއަކުންކަން ކަނޑައެޅުން: ކޯޑް_ބްލޮކް_10 ޗެޓް މަސްދަރުތައް:

• 0 - ވައިބަރ
• 1 - ވައިބަރބޮޓް
• 2 - ޓެލެގްރާމްބޮޓް
• 3 - ވަޓްސްއެޕް
• 4 - ވިޖެޓް
• 5 - ރޮޒެޓްކާ
• 6 - ފޭސްބުކް
• 7 - އިންސްޓަގްރާމް