Chemaxon Calculators and Predictors service is secured from unauthorized use by restricting API calls to those that provide proper authentication credentials. These credentials are in the form of an API key - a unique alphanumeric string associated to your AWS account.
Once you subscribe to Calculation and Predictor's service on AWS Marketplace, you will be redirected to our welcome page where you can redeem your API key.
{primary} Save the key and store it at a safe place. This is the only time we will show you the API key.
To gain access to our services, you must add the x-api-key header to all of your requests. The value of the header must be the API key, nothing else:
x-api-key: <YOUR_API_KEY>For detailed examples, check the Code examples section.
To revoke your API key you have to unsubscribe from our services on the AWS Marketplace product page. This action will trigger mechanisms in the background, that will revoke your API keys immediately.
We don't provide this functionality as is, but you can unsubscribe from using Chemaxon Calculators and Predictors on AWS Marketplace product page and subscribe again. This will have the effect of revoking your current API key and getting a new one.
Subscribing and unsubscribing to the service is free of charge. We will bill you only for the API calls you make.
You can check any time if your API key is still valid at marketplace.calculators.cxn.io. In case of a valid API key we will provide additional information, like the pricing plan, you belong to. For more information, see Pricing.
Each request is allowed to run for a maximum of 25 seconds. After that time period your request will timeout and return with HTTP status code 504 Gateway Timeout.
A rate limit is the number of API calls a user can make within a given time period. Our system is limiting API calls to 50 request/sec. Please note, this is not hard limit, it is applied on a best-effort basis. In some cases, you can exceed the rate that you set.
Calculators and Predictors on AWS Marketplace provides an API (/rest-v1/calculator/batch/calculate) that allows calculations for multiple structures within a single call.
The maximum number of structures is limited to 25 structures.
Temporary API documentation can be found at this swagger page.
What is AWS PrivateLink?
AWS PrivateLink is a highly available, scalable technology that enables you to privately connect your VPC to services as if they were in your VPC. Therefore, you control the specific API endpoints, sites, and services that are reachable from your VPC.
How to connect to Chemaxon Calculators and Predictors using the PrivateLink option?
Amazon provides a great step-by-step documentation on how to access SaaS products through AWS PrivateLink - please follow the steps described here.
The following section provides code examples in different languages, on how to use a basic calculator (Elemental Analysis) by authenticating the request using the API key.
curl -X 'POST' \
'https://api.calculators.cxn.io/rest-v1/calculator/calculate/elemental-analysis' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"structure": "NC(CC1=CC=CC=C1)C(O)=O"
}'const url = 'https://api.calculators.cxn.io/rest-v1/calculator/calculate/elemental-analysis';
const payload = {
structure: 'NC(CC1=CC=CC=C1)C(O)=O'
};
const response = await fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY',
},
body: JSON.stringify(payload)
});import requests
url = 'https://api.calculators.cxn.io/rest-v1/calculator/calculate/elemental-analysis'
payload = { 'structure': 'NC(CC1=CC=CC=C1)C(O)=O' }
my_headers = {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
response = requests.post(url, json=payload, headers=my_headers)import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
import com.google.gson.Gson;
public class App {
public static void main(String[] args) {
// This code requires Java 11 or newer
var request = HttpRequest.newBuilder()
.uri(URI.create("https://api.calculators.cxn.io/rest-v1/calculator/calculate/elemental-analysis"))
.header("x-api-key", "YOUR_API_KEY")
.header("Content-Type", "application/json")
.POST(BodyPublishers.ofString("{ \"structure\": \"NC(CC1=CC=CC=C1)C(O)=O\" }"))
.timeout(Duration.ofSeconds(5))
.build();
var responseStr = HttpClient.newHttpClient()
.sendAsync(request, BodyHandlers.ofString())
.thenApply(HttpResponse::body)
.join();
// Multiple libraries are available to parse the JSON response, e.g., gson (https://github.com/google/gson)
var response = new Gson().fromJson(responseStr, Response.class);
}
static class Response {
private double mass;
private double exactMass;
private String formula;
// ... other fields
// ... getters, setters
}
}Coming soon...
In case you need a new API key, you have to unsubscribe from this product on AWS Marketplace page and subscribe again. This process will remove your previous API key associated to your account and assign a new one.
No, you can have only a single API key associated to your AWS account.
Subscribing and unsubscribing to the service is free of charge. We will bill you only for the API calls you make.
Each chemical calculation has a different price based on how complex it is. For the detailed list, see Pricing.