Skip to main content

Service Limits

Reasonable service limits have been established to ensure that everyone can reliably use the service.

Reserved Field Name​

The Mockd API does not allow certain field names that are reserved for system usage. You may not use field name mockdSuccess in any request made to the Mockd API. Sending a system reserved name for the field name will result in the following message:

Example Request
{
    "fields": {
        "mockdSuccess": "bool"
    }
}
HTTP 422 Response
{
    "mockdSuccess": false,
    "message": "Request contains a system reserved field name: mockdSuccess"
}

Per-Request Limits​

Each POST request should contain no more than 100 fields per request. This has been implemented to ensure that all requests have a reasonable response time. Exceeding this amount will result in the rejection of the entire request.

HTTP 403
{
    "success": false,
    "message": "Service currently limited to 100 fields per request!"
}

Per-User Limits​

Users of this free service are asked to limit requests to 100 requests per minute. Exceeding this amount will result in the rejection of the entire request.

HTTP 429 Too Many Requests
{
    "success": false,
    "message": "Too many requests"
}

Each response contains a response header from the server indicating your remaining request tokens for this 1 minute interval. You may use the Remaining-Requests server response header to track your remaining tokens. This number resets every minute.