Introduction

🇮🇹 Questa documentazione è disponibile esclusivamente in lingua inglese.

iSmartFrame offers REST API so that you can programmatically integrate iSF in your application.

Request and response encoding

All of our application programming interfaces (APIs) accept request bodies encoded in JSON format, and they provide responses encoded in JSON format as well. We have designed our APIs to efficiently handle the exchange of data in this widely-used and versatile format, ensuring a smooth and standardized communication process between clients and our services.

Error codes

The API utilizes traditional HTTP error codes to communicate status and error information between the client and the server in a standardized manner, ensuring seamless interoperability and effective error handling throughout the communication process.

Error Code

Description

2xx OK

Everything worked as expected.

400 Bad request

The request was unacceptable, often due to missing or invalid parameter(s). In this case a JSON-encoded error response is returned.

401 Unauthorized

User is not authorised to perform the request.

429 Too Many Requests

Too many requests hit the API too quickly. We recommend you to throttle request rate as per the value of X-RateLimit-Limit and X-RateLimit-Reset response headers and stay within Rate Limit.

500, 502, 503, 504 Server error

Something went wrong with iSmartFrame.com API. Please create a support ticket by emailing us at support@akatop.atlassian.net.

Last updated