Errors

Status codes and the meaning behind them

200 - OK

Your request was successful and will receive the appropriate response.

Solutions

• N/A

400 - Bad Request

Your request was malformed. This will be given if no other errors were picked up.

Solutions

• Double check the request you are making.

401 - Unauthorized

You aren't authorized to make any requests to the API.

Solutions

• Register on our platform and get an API token then read about authorizing your requests.

• If you are registered, generate a new API token and replace the new token with your old one.

403 - Forbidden

You are registered but you don't have an active subscription, or, you ran out of credits (URLs).

Solutions

• Make sure you are signed up for a plan, see available plans.

• Make sure you have enough credits (URLs).

• Make sure your credit card has not expired and have available funds.

Credit card details are not stored on our system. All payments are done via payfast.co.za To update your credit card details, please visit payfast.co.za

404 - Not Found

You are hitting an API endpoint that doesn't exist.

Solutions

• Check the endpoint and make sure it exists with us.

422 - Unprocessable Entity

The values inside your request doesn't agree with the validations put in place.

Solutions

• Make sure you are sending valid data, for example: URL should start with http://.

429 - Too Many Requests

You are simply hitting the server with too many requests in a short period of time.

Solutions

• Send less requests.

• Use the X-RateLimit-Remaining value from response headers to your advantage.

To check the limits, get the X-RateLimit-Limit value from response headers. Default: 60 per minute

500 - Internal Server Error

The server failed processing the request. It can be anything on our side, please report this!

Solutions

• If you think your request is valid, please report your issue immediately so we can fix it!

Contact details at https://shrtnr.co/contact

503 - Maintenance

We are doing upgrades and/or fixes to our platform.

Solutions

• Server will respond with a Retry-After value (in seconds) from response headers for you to retry any failed requests.

This won't happen often, but if it does, it will only be to improve the platform!