API Reference

Munashe Tech API Documentation

Complete reference guide for integrating with the Munashe Tech API platform. Build powerful applications with our RESTful API.

Authentication
Endpoints
Examples
Rate Limits

Base URL

https://api.munashetech.co.zw/v1

Authentication

API Keys
Authenticate your requests using Bearer token authentication

Include your API key in the Authorization header of every request:

Authorization: Bearer YOUR_API_KEY
Security Best Practices
  • Never expose your API keys in client-side code
  • Rotate your API keys regularly
  • Use environment variables to store keys
  • Implement rate limiting in your applications
  • Monitor API usage for unusual patterns

API Endpoints

GET/api/v1/users
Retrieve a list of all users
Auth Required

Parameters

pageintegerPage number for pagination
limitintegerNumber of items per page
sortstringSort by field (e.g., 'created_at')
GET/api/v1/users/{id}
Retrieve a specific user by ID
Auth Required

Parameters

idstringUser IDRequired
POST/api/v1/users
Create a new user
Auth Required

Parameters

emailstringUser emailRequired
namestringUser full nameRequired
rolestringUser role (admin, user)
PUT/api/v1/users/{id}
Update an existing user
Auth Required

Parameters

idstringUser IDRequired
emailstringUser email
namestringUser full name
DELETE/api/v1/users/{id}
Delete a user
Auth Required

Parameters

idstringUser IDRequired
GET/api/v1/products
Retrieve a list of all products
Auth Required

Parameters

pageintegerPage number for pagination
categorystringFilter by category
POST/api/v1/analytics/track
Track analytics events
Auth Required

Parameters

eventstringEvent nameRequired
propertiesobjectEvent properties

Code Examples

curl -X GET "https://api.munashetech.co.zw/v1/users" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Format

Success Response
All successful responses follow this format
{
  "success": true,
  "data": {
    "id": "usr_123456",
    "email": "user@example.com",
    "name": "John Doe",
    "created_at": "2025-01-15T10:30:00Z"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "req_abc123"
  }
}
Error Response
All error responses follow this format
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid email format",
    "details": {
      "field": "email",
      "value": "invalid-email"
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "req_abc123"
  }
}

HTTP Status Codes

200OK

Request succeeded

201Created

Resource created successfully

400Bad Request

Invalid request parameters

401Unauthorized

Invalid or missing API key

403Forbidden

Insufficient permissions

404Not Found

Resource not found

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Server error occurred

Rate Limits

Request Limits
API rate limits are based on your subscription tier
Free
100 requests/hour
10 requests/minute
Pro
1,000 requests/hour
50 requests/minute
Enterprise
10,000 requests/hour
500 requests/minute
Rate Limit Headers
Every response includes rate limit information
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1642348800

Official SDKs

JavaScript
npm install @munashetech/sdk
Python
pip install munashetech
Go
go get github.com/munashetech/sdk
Ruby
gem install munashetech

Ready to Get Started?

Sign up for a free API key and start building with Munashe Tech today.