API ya Wasanidi Programu

Sandbox na marejeleo ya API

API nyepesi ya REST kwa bei, usajili na ukusanyaji wa bima. Anza kwa sandbox hapo chini, kisha omba ufunguo ili kwenda kwa hai.

Tuma ombi la ufunguo wa sandbox

URL ya msingi ya API

Tumia msingi huu kwa mwito wote wa sandbox na API hai.

URL ya msingi ya API

https://api.modela.co.ke

Sandbox ya kuwasilisha mwanzo

Tunga usajili wa mkulima. Hakuna sera halisi inayoandikwa, hivyo unaweza kuunganisha na kujaribu kwa usalama.

POST/api/v1/public/sandbox/enrol

Tunga usajili wa mkulima. Hakuna sera halisi inayoandikwa, hivyo unaweza kuunganisha na kujaribu kwa usalama.

Sandbox ya kuwasilisha mwanzo

POST/api/v1/public/sandbox/quote

Omba makisio ya bima na kiasi cha bima kwa kaunti, bidhaa na aina ya mkulima fulani. Hakuna malipo yanayofanywa.

Sandbox ya kutoa bei

POST/api/v1/public/sandbox/collect

Tunga ombi la ukusanyaji wa bima wa M-Pesa. Katika sandbox, hakuna pesa halisi inayohamishwa.

Sandbox ya kukusanya bima

POST /api/v1/public/sandbox/enrol

Mfano wa ombi

POST /api/v1/public/sandbox/enrol
Content-Type: application/json
Authorization: Bearer $SANDBOX_TOKEN

{
  "farmer_msisdn": "+254712345678",
  "county": "Kitui",
  "product_code": "kaip-maize-2026",
  "consent_sms": true
}

Mfano wa jibu

{
  "success": true,
  "policy_ref": "SANDBOX-A1B2C3D4E5F6",
  "status": "pending"
}

Mfano wa kosa

{
  "success": false,
  "error": "consent_required",
  "message": "Farmer must confirm enrolment via SMS before cover can be activated."
}

Sandbox ya kuwasilisha mwanzo

farmer_msisdnrequired: Nambari ya simu ya mkulima katika umbizo la E.164.
countyrequired: Kaunti ya Kenya ambapo shamba lipo.
product_coderequired: Msimbo wa bidhaa kwa ulinzi unaochunguzwa.
consent_smsrequired: Lazima iwe kweli — thibitisha idhini ya SMS kabla ya usajili.

Tayari kwa ufikiaji wa hai?

Majibu ya sandbox ni ya kubuni. Ili kuweka sera halisi, tuma ombi la ufunguo wa sandbox na tutaweka kitambulisho cha mshirika.

Tuma ombi la ufunguo wa sandbox