REST API
STINGAllo REST API
The STINGAllo supports RESTful (REpresentational State Transfer) Web Services to make accessing data easier.
Endpoint
GET https://www.stingallo.cbi.cnptia.embrapa.br/api/afrsParameters
Both are required.
| Parameter | Description | Type | Default Value | Required | Possible Values |
|---|---|---|---|---|---|
pdb_id |
PDB ID of the protein. Case insensitive. | String | None | Yes | 4-character PDB code |
chain_id |
Chain ID of the protein structure. | String | None | Yes | Any chain letter (e.g., A) |
Common use cases
Here are two common ways to use the API, using Python
with requests and Terminal with
curl.
1. Using Python with Requests (GET Method)
import requests
url = 'https://stingallo.cbi.cnptia.embrapa.br/api/afrs'
params = {"pdb_id": "1A01", "chain_id": "A"}
response = requests.get(url, params=params)
print(response.json())
2. Using Terminal with Curl (GET Method)
curl -X GET "https://www.stingallo.cbi.cnptia.embrapa.br/api/afrs?pdb_id=1A01&chain_id=A"
Example JSON response
{
"allosteric_residues":
[
"126", "103", "100", "101", "36", "96"
],
"chain_id": "A",
"pdb_id": "1A01"
}
allosteric_residues holds the residue sequence numbers as
strings.
Limits
| Limit | Value | Response when exceeded |
|---|---|---|
| Requests per IP per day | 100 | 429 — API request limit exceeded (100 per day). |
Distinct pdb_id per IP per day |
30 | 429 — Unique pdb_id limit exceeded (30 per day). |
Missing pdb_id or chain_id |
— | 400 — Please provide both pdb_id and chain_id. |
| No prediction for that chain | — | 404 — No allosteric residues found or invalid pdb_id/chain_id. |
Support
For any questions, contact folorunsho.omage@colaborador.embrapa.br.