Online Compiler and IDE
Compiler API
Compiler API FAQ
What this service is?
JDoodle Compiler is an online API service to compile and execute Programs online via APIs, it supports Java, C/C++, PHP, Perl, Python, Ruby and many more languages.
What type of API it is?
It is a JSON based Rest API.
Can I call your API directly from a web page?
This APIs are meant for server to server call and protected with client ID and Client Secret, if you make call directly from web page then you have to expose your personal client ID and Secret in the page which is not secure and we request you not to do that. Best way is to direct the request from your webpage to your own server and call JDoodle API from your server.
Is web socket supported?
Web socket is not supported in our public offering. Available in unlimited/custom plans.
What is the request endpoint for compiler api?
https://api.jdoodle.com/v1/execute (only POST method supported with Content-Type: application/json)
What is the request endpoint to check my today's usage?
https://api.jdoodle.com/v1/credit-spent (only POST method supported with Content-Type: application/json)
What subscription options available?
We have got multiple plans including a Free plan, please refer compiler-api home page for current Plans.
Is plan costs are in USD?
All the cost mentioned is in USD.
Can I change from one plan to another plan?
Yes. if you are upgrading from lower volume plan to upper volume plan, your change will be immediate. if you are moving from upper volume plan to lower volume plan, your change will be effective from end of your current billing period
What is a billing period and when my credit card charged?
When you subscribe to a paid plan first time, you are paying for the plan and your billing period starts from that date, your credit card will be charged every month on that day. For example, if you subscribe for a paid plan on 5th November, your billing period is 5th of every month, and you will be charged on 5th of every month.
How cost calculated when I move from lower volume plan to upper volume plan and when I will be charged (upgrade)?
You are always charged only on your billing date, that is at the end of current billing period. if you move to upper volume plan, the cost is calculated on prorate basis and the additional cost for the current billing period will be included in the next payment. For example, if your billing period starts on 1st April and your current plan is $10 per Month, if you are moving to $20 plan on 16th of April. Your next bill will be calculated approximately like = (usage on current plan $10 on prorate from 1st to 15th) $5 + (usage on new plan $20 for 16th to 30th on prorate basis) $10 + (next billing period cost for 1st May to 31st May) $20 - (Amount you have already paid for 1st to 30th April) $10 = $25.
How cost calculated when I move from upper volume plan to lower volume plan (downgrade)?
When you are moving from upper volume plan to lower lower volume plan, the change is effective only from start of your next billing period, so you will be charged for new plan from start of new billing period. you can continue use your current plan until the end of current billing period, no refund provided.
What happens when I cancel my subscription?
if you are on Free plan, the cancellation will be processed immediately. if you are on Paid plan, your subscription will be cancelled at the end of your current billing period, you can use your plan until end of current billing period. no refund provided.
Can I reactivate my subscription?
If you cancelled, you can reactivate any time until the end of your current billing period. if end of billing period reached, you have to subscribe again.
Is My Credit Card Details safe?
We use Stripe for all Credit Card processing, we are not storing or handling your Credit Card details in our systems.
What are the Input Parameters for execute api call?
Parameter
Description
clientId
Client ID for your subscription
clientSecret
Client Secret for your subscription
script
program to compile and execute
stdin
StdIn
language
language of the script (refer the supported language list below)
versionIndex
version of the language to be used (refere the supportoed languages and versions in list below)
What are the Output Parameters for execute api call when the execution is successful?
Parameter
Description
output
Output of the program
statusCode
Status Code of the result
memory
Memory used by the program
cpuTime
CPU Time used by the program
What are the Output Parameters for execute api call when the execution failed?
Parameter
Description
error
error message
statusCode
Status Code of the result
What are the Input Parameters for "credit-spent" api call?
Parameter
Description
clientId
Client ID for your subscription
clientSecret
Client Secret for your subscription
What are the Output Parameters for "credit-spent" api call when the execution is successful?
Parameter
Description
used
No of credits used today
What are the Output Parameters for "credit-spent" API call when the execution failed?
Parameter
Description
error
error message
statusCode
Status Code of the result
What languages and versions are supported?
Language
(not passed in request)
Language Code
(passed in request)
Version
(not passed in request)
VersionIndex
(this is what passed in request)
Java
java
JDK 1.8.0_66
0
JDK 9.0.1
1
JDK 10.0.1
2
JDK 11.0.4
3
JDK 17.0.1
4
C
c
GCC 5.3.0
0
Zapcc 5.0.0
1
GCC 7.2.0
2
GCC 8.1.0
3
GCC 9.1.0
4
GCC 11.1.0
5
C-99
c99
GCC 5.3.0
0
GCC 7.2.0
1
GCC 8.1.0
2
GCC 9.1.0
3
GCC 11.1.0
4
C++
cpp
GCC 5.3.0
0
Zapcc 5.0.0
1
GCC 7.2.0
2
Java Example for Execute API Call?
Below is a quick and dirty Java example, but please use your favorite rest API client and JSON Java libraries for clean code and for production use.
1
package com.jdoodle;
2
3
import java.io.BufferedReader;
4
import java.io.IOException;
5
import java.io.InputStreamReader;
6
import java.io.OutputStream;
7
import java.net.HttpURLConnection;
8
import java.net.MalformedURLException;
9
import java.net.URL;
10
11
public class APITest {
12
public static void main(String args[]) {
13
14
String clientId = "YourClientID"; //Replace with your client ID
15
String clientSecret = "YourClientSecret"; //Replace with your client Secret
16
String script = "";
17
String language = "php";
18
String versionIndex = "0";
19
20
try {
21
URL url = new URL("https://api.jdoodle.com/v1/execute");
22
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
23
connection.setDoOutput(true);
24
connection.setRequestMethod("POST");
25
connection.setRequestProperty("Content-Type", "application/json");
26
27
String input = "{\"clientId\": \"" + clientId + "\",\"clientSecret\":\"" + clientSecret + "\",\"script\":\"" + script +
28
"\",\"language\":\"" + language + "\",\"versionIndex\":\"" + versionIndex + "\"} ";
29
30
System.out.println(input);
31
32
OutputStream outputStream = connection.getOutputStream();
33
outputStream.write(input.getBytes());
34
outputStream.flush();
35
36
if (connection.getResponseCode() != HttpURLConnection.HTTP_OK) {
37
throw new RuntimeException("Please check your inputs : HTTP error code : "+ connection.getResponseCode());
38
}
39
40
BufferedReader bufferedReader;
41
bufferedReader = new BufferedReader(new InputStreamReader(
42
(connection.getInputStream())));
43
44
String output;
45
System.out.println("Output from JDoodle .... \n");
46
while ((output = bufferedReader.readLine()) != null) {
47
System.out.println(output);
48
}
49
50
connection.disconnect();
51
52
} catch (MalformedURLException e) {
53
e.printStackTrace();
54
} catch (IOException e) {
55
e.printStackTrace();
56
}
57
}
58
}
Copied!
NodeJs Example for Execute API Call?
1
var request = require('request');
2
3
var program = {
4
script : "",
5
language: "php",
6
versionIndex: "0",
7
clientId: "YourClientID",
8
clientSecret:"YourClientSecret"
9
};
10
request({
11
url: 'https://api.jdoodle.com/v1/execute',
12
method: "POST",
13
json: program
14
},
15
function (error, response, body) {
16
console.log('error:', error);
17
console.log('statusCode:', response && response.statusCode);
18
console.log('body:', body);
19
});
Copied!
Curl Example for execute API Call?
Below is an Curl example (note: may need slight syntax change in windows)
1
curl -H "Content-Type: application/json; charset=UTF-8" -X POST -d '{"clientId": "YourClientId","clientSecret":"YourClientSecret","script":"","language":"php","versionIndex":"0"}' https://api.jdoodle.com/v1/execute
Copied!
Curl Example for "credit-spent" API Call?
Below is an Curl example (note: may need slight syntax change in windows)
1
curl -H "Content-Type: application/json; charset=UTF-8" -X POST -d '{"clientId": "YourClientId","clientSecret":"YourClientSecret"}' https:
Copied!
Postman Examples?
Select "Raw" type and "JSON"
Content Type should be application/json
Do yo have any client Library for these APIs?
We don't provide API client libraries, but you can generate client libraries in so many different languages, using http://editor.swagger.io/ and the below JSON API Description. Simply go to http://editor.swagger.io/, copy paste the below JSON into the editor, click on Generate Client and select the language.
1
{
2
"swagger": "2.0",
3
"info": {
4
"description": "JDoodle Compiler API",
5
"version": "1.0.0",
6
"title": "JDoodle Compiler API",
7
"termsOfService": "https://www.jdoodle.com/terms",
8
"contact": {
9
"email": "[email protected]"
10
}
11
},
12
"host": "api.jdoodle.com",
13
"basePath": "/v1",
14
"consumes": [
15
"application/json"
16
],
17
"produces": [
18
"application/json"
19
],
20
"paths": {
21
"/execute": {
22
"post": {
23
"summary": "Execute Program",
24
"description": "Endpoint to execute code",
25
"tags": [
26
"execute"
27
],
28
"parameters": [
29
{
30
"name": "execute",
31
"in": "body",
32
"description": "the body",
33
"required": true,
34
"schema": {
35
"properties": {
36
"clientId": {
37
"type": "string"
38
},
39
"clientSecret": {
40
"type": "string"
41
},
42
"script": {
43
"type": "string"
44
},
45
"stdin": {
46
"type": "string"
47
},
48
"language": {
49
"type": "string"
50
},
51
"versionIndex": {
52
"type": "string"
53
}
54
}
55
}
56
}
57
],
58
"responses": {
59
"200": {
60
"description": "Execution success",
61
"schema": {
62
"type": "object",
63
"properties": {
64
"output": {
65
"type": "string",
66
"description": "Output"
67
},
68
"statusCode": {
69
"type": "integer",
70
"description": "Status Code"
71
},
72
"memory": {
73
"type": "number",
74
"description": "Memory used"
75
},
76
"cpuTime": {
77
"type": "number",
78
"description": "CPU Time used"
79
}
80
}
81
},
82
"401": {
83
"description": "Unauthorized"
84
},
85
"429": {
86
"description": "Daily limit reached"
87
}
88
}
89
}
90
},
91
"/credit-spent": {
92
"post": {
93
"summary": "Credit Spent",
94
"description": "Endpoint to execute code",
95
"tags": [
96
"credit-spent"
97
],
98
"parameters": [
99
{
100
"name": "credit",
101
"in": "body",
102
"description": "the body",
103
"required": true,
104
"schema": {
105
"properties": {
106
"clientId": {
107
"type": "string"
108
},
109
"clientSecret": {
110
"type": "string"
111
}
112
}
113
}
114
}
115
],
116
"responses": {
117
"200": {
118
"description": "Execution success",
119
"schema": {
120
"type": "object",
121
"properties": {
122
"used": {
123
"type": "integer",
124
"description": "No of credits used today"
125
}
126
}
127
}
128
},
129
"401": {
130
"description": "Unauthorized"
131
}
132
}
133
}
134
}
135
},
136
"externalDocs": {
137
"description": "Find out more about JDoodle Compiler API",
138
"url": "https://www.jdoodle.com/compiler-api"
139
}
140
}
Copied!
Where can I find help and support?
for any help, doubts, suggestions, etc, get in touch with us at [email protected]
Copy link
Contents
What this service is?
What type of API it is?
Can I call your API directly from a web page?
Is web socket supported?
What is the request endpoint for compiler api?
What is the request endpoint to check my today's usage?
What subscription options available?
Is plan costs are in USD?
Can I change from one plan to another plan?
What is a billing period and when my credit card charged?
How cost calculated when I move from lower volume plan to upper volume plan and when I will be charged (upgrade)?
How cost calculated when I move from upper volume plan to lower volume plan (downgrade)?
What happens when I cancel my subscription?
Can I reactivate my subscription?
Is My Credit Card Details safe?
What are the Input Parameters for execute api call?
What are the Output Parameters for execute api call when the execution is successful?
What are the Output Parameters for execute api call when the execution failed?
What are the Input Parameters for "credit-spent" api call?
What are the Output Parameters for "credit-spent" api call when the execution is successful?
What are the Output Parameters for "credit-spent" API call when the execution failed?
What languages and versions are supported?
Java Example for Execute API Call?
NodeJs Example for Execute API Call?
Curl Example for execute API Call?
Curl Example for "credit-spent" API Call?
Postman Examples?
Do yo have any client Library for these APIs?
Where can I find help and support?