MangoV3 Public API Documentation#
Overview#
MangoV3 Public API provides programmatic access to e-commerce operations including product catalog, order management, and webhook integrations. The API uses API key authentication and follows RESTful principles. All responses are in JSON format. Once you sign up for an account, you will be provided with a real API key (get here)Base URL: https://v3.mangoteeprints.com/api/public/v1Authentication#
All API requests require authentication using an API key in the header:Rate Limiting#
| Endpoint Type | Limit |
|---|
| Default | 10 requests per second |
The following headers are returned with each response:X-RateLimit-Limit: Maximum requests allowed
X-RateLimit-Remaining: Remaining requests
X-RateLimit-Reset: Unix timestamp for limit reset
{
"status": true,
"code": "SUCCESS",
"message": "Operation completed successfully",
"data": {},
"timestamp": "2025-01-22T10:00:00Z",
"request_id": "uuid-string"
}
Response Fields#
| Field | Type | Description |
|---|
status | boolean | Success/failure indicator |
code | string | Response code for programmatic handling |
message | string | Human-readable message |
data | object/null | Response payload |
timestamp | string | ISO 8601 timestamp |
request_id | string | Unique request identifier for debugging |
Error Handling#
{
"status": false,
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"data": {
"errors": [
{
"field": "shipping_method",
"message": "Field required",
"type": "missing"
}
]
}
}
Common Error Codes#
| Code | Description |
|---|
UNAUTHORIZED | Invalid or missing API key |
FORBIDDEN | Insufficient permissions |
VALIDATION_ERROR | Request validation failed |
NOT_FOUND | Resource not found |
RATE_LIMIT_EXCEEDED | Too many requests |
INTERNAL_ERROR | Server error |
Modified at 2025-08-30 16:23:22
