Patascore
Financial health. Financial Prosperity. Financial wealth.
This document defines the new web service specifications for the Patascore services. It also illustrates the technologies and protocols used to support cross platform cross language interaction between the Patascore web services and Patascore clients. The API is REST based, and the data-exchange format is JSON. The API follows HTTP rules, enabling a wide range of HTTP clients can be used to interact with the API.
General Principals
Root of the API
The API gateway offers a set of endpoints that can be reached via the following root URI’s depending on the environment:
Development/Testbed: https://dev.api.patascore.com/
Production: https://api.patascore.com/
Available HTTP VERBS
Patascore APIs use appropriate HTTP verbs for every action
Method | Description |
GET | Used for retrieving resources. |
POST | Used for creating resources and performing resource actions. |
PUT | Used for updating resources. |
DELETE | Used for deleting resources. |
Data submitted to the API must be in JSON format, all responses from the API are also in JSON format.
Response Structure
The response structure for Patascore APIs follows the below format.
Webhooks/Callback URLs
Webhooks are user-defined HTTP callbacks triggered by an event. Patascore uses webhooks to asynchronously let your application know when events happen Eg,
Mpesa statement analytics process completion
CRB data fetch completion
Errors
Errors are always returned as an array of error objects, keyed by errors in the top level of a JSON object along with an error status & message
Last updated