Developers API
Integrate our bypass detection into your applications seamlessly. Fully transparent and easy to implement for your software.
1. Generate Shortened Link
Use this endpoint to create a new shortened link targeting your destination URL automatically via the bot's connected shorteners.
GET https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&url=YOUR_DESTINATION_URL&alias=OPTIONAL_ALIAS
Parameters
- api (required): Your developer API key (obtained via
/get_apiin the bot). - url (required): The destination URL you want to gate/shorten.
- alias (optional): A custom alias for the generated link.
Usage Examples
curl -X GET "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&url=https://example.com"
import requests
url = "https://AntiBypass.csbots.in/api"
params = {
"api": "YOUR_API_KEY",
"url": "https://example.com"
}
response = requests.get(url, params=params)
print(response.json())
<?php
$api_url = "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&url=" . urlencode("https://example.com");
$response = file_get_contents($api_url);
$data = json_decode($response, true);
print_r($data);
?>
const axios = require('axios');
axios.get('https://AntiBypass.csbots.in/api', {
params: {
api: 'YOUR_API_KEY',
url: 'https://example.com'
}
})
.then(response => console.log(response.data))
.catch(error => console.error(error));
JSON Response - Success
{
"status": "success",
"shortenedUrl": "https://short.site/alias"
}
JSON Response - Error
{
"status": "error",
"error_code": 8,
"error": "Invalid API key or URL parameter missing"
}
2. Check Verification Status
Use this endpoint to verify if a specific shortened link (identified by its alias) has been successfully completed by a user.
GET https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&alias=ALIAS&user_id=USER_ID
Parameters
- api (required): Your developer API key.
- alias (required): The specific shortened alias you want to check the status for.
- user_id (required): ID of the user you want to track for verification status.
Usage Examples
curl -X GET "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&alias=ALIAS&user_id=USER_ID"
import requests
url = "https://AntiBypass.csbots.in/api"
params = {
"api": "YOUR_API_KEY",
"alias": "ALIAS",
"user_id": "USER_ID"
}
response = requests.get(url, params=params)
print(response.json())
<?php
$api_url = "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&alias=ALIAS&user_id=USER_ID";
$response = file_get_contents($api_url);
$data = json_decode($response, true);
print_r($data);
?>
const axios = require('axios');
axios.get('https://AntiBypass.csbots.in/api', {
params: {
api: 'YOUR_API_KEY',
alias: 'ALIAS',
user_id: 'USER_ID'
}
})
.then(response => console.log(response.data))
.catch(error => console.error(error));
JSON Response - Verified (Success)
{
"status": "success"
}
JSON Response - Pending (View counted but not confirmed for this specific alias yet)
{
"status": "pending"
}
JSON Response - Failed (No views recorded)
{
"status": "failed"
}
3. Check 24-Hour Global Status
Use this endpoint to verify if a user has completed any verification for your active shortener within the last 24 hours.
GET https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&user_id=USER_ID
Parameters
- api (required): Your developer API key.
- user_id (required): The unique ID of the user you want to check.
Usage Examples
curl -X GET "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&user_id=USER_ID"
import requests
url = "https://AntiBypass.csbots.in/api"
params = {
"api": "YOUR_API_KEY",
"user_id": "USER_ID"
}
response = requests.get(url, params=params)
print(response.json())
<?php
$api_url = "https://AntiBypass.csbots.in/api?api=YOUR_API_KEY&user_id=USER_ID";
$response = file_get_contents($api_url);
$data = json_decode($response, true);
print_r($data);
?>
const axios = require('axios');
axios.get('https://AntiBypass.csbots.in/api', {
params: {
api: 'YOUR_API_KEY',
user_id: 'USER_ID'
}
})
.then(response => console.log(response.data))
.catch(error => console.error(error));
JSON Response - Success
{
"status": "success",
"verified": true
}
4. Error Handling
If the API encounters an error during processing, it will return a JSON object containing an error_code and an error key with a descriptive message. Make sure your script handles these gracefully.
| Code | Failure Type | Description | Resolution |
|---|---|---|---|
1 |
Missing API Parameter | The api query parameter was not provided. |
Ensure you append ?api=YOUR_KEY in the URL. Get it from @None using /get_api. |
2 |
Invalid API Key | The provided API key does not exist or is malformed. | Verify your API key matches exactly what the bot provided. |
3 |
Missing Credentials | Your shortener credentials (username/password/site) are missing in the DB. | Contact @None to re-authenticate or update your shortener connection. |
4 |
Missing user_id | The `user_id` tracking parameter was not provided in Endpoint 2. | Append `&user_id=` to your request URL. |
5 |
API Disabled | The API Owner has disabled API access. | The API owner must enable API access from their account settings. |
6 |
Site Script Not Found | The shortener module associated with your account cannot be loaded. | The bot may not support this shortener anymore, or there is an internal misconfiguration. Contact support. |
7 |
Failed to Call Shortener API | The underlying shortener API rejected the request or timed out. | Check if your connected shortener account is active, or try again later. |
8 |
Internal Error / Invalid Params | Unhandled exception, or you requested without alias and without url. |
Make sure you specify either url (to shorten) or alias (to check). Contact support if it persists. |