API to run the code

Users can integrate the API from their backend servers and execute the code programmatically.
Following is the cURL to call the /run API to execute code

curl --location --request POST 'https://onecompiler.com/api/v1/run?access_token=your_access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
  "language": "python",
  "stdin": "Peter",
  "files": [
    {
      "name": "HelloWorld.py",
      "content": "import sys\nname = sys.stdin.readline()\nprint('\''Hello '\''+ name)"
    }
  ]
}'

Response:

{
	"stdout": "Hello Peter\n",
	"stderr": null,
	"exception": null,
	"executionTime": 41,
	"limitPerMonthRemaining": 74694
	"status": "success",
}

status values: success/ failed (ex. API key is invalid/ API quota exceeded/ Invalid language id etc.,)

Common error scenarios and their responses:

API operation timedout:

{
    "status": "success",
    "error": "E001: operation timed out"
}

Exceeded rate limits:

{
    "status": "failed",
    "error": "E002: API quota exceeded"
}

Invalid API Token:

{
    "status": "failed",
    "error": "E003: invalid access_token"
}

Unsuppoted language:

{
    "status": "failed",
    "error": "E006: unsupported language flutter"
}

API to get the list of supported languages

http://onecompiler.com/api/v1/languages

Following are the list of supported languages and their ids

Flags

persist : To persist the output URL for 1 hour
--table : To display the output in table format
--tabbed : To display the output in tabbed format
--vertical : To display the output in vertical format

Batch execution

If you plan to run the same code with multiple STDIN values, which is common when executing test cases, the API supports passing stdin as an array. When an array of values is provided, the API executes the code multiple times, once for each stdin value, and returns a list of response objects corresponding to each execution.