Isarud API 문서
제재 심사 및 위험 인텔리전스 API.
Multi-Platform Access
Access your screening data and trade compliance tools from any device.
인증
모든 API 요청에는 Bearer 토큰이 필요합니다. 대시보드에서 API 키를 생성하세요 (Business 플랜 필수).
Authorization: Bearer YOUR_API_KEY
기본 URL
https://isarud.com/api/v1
All requests must use HTTPS. Responses are JSON.
엔드포인트
/v1/screen
단일 이름을 모든 제재 목록과 비교하여 심사합니다.
Request
{
"name": "Ali Khamenei",
"type": "individual"
}
Response
{
"success": true,
"data": {
"query": "Ali Khamenei",
"total_matches": 3,
"results": [
{
"name": "Ali Hosseini KHAMENEI",
"list": "OFAC SDN",
"score": 95,
"type": "individual",
"country": "IR"
}
]
}
}
name (required) — Entity name to screen. type (optional) — individual or entity.
/v1/screen/{id}
Retrieve details of a previous screening by ID.
/v1/screen/batch
최대 500개의 이름을 일괄 심사합니다. JSON 배열 또는 CSV.
Request
{
"names": ["Name One", "Name Two", "Name Three"]
}
Response
{
"success": true,
"data": {
"total": 3,
"results": [
{"name": "Name One", "matches": 0},
{"name": "Name Two", "matches": 2},
{"name": "Name Three", "matches": 0}
]
}
}
/v1/briefs
최신 위험 인텔리전스 브리프를 확인하세요.
/v1/briefs/{id}
Retrieve a specific OSINT risk brief by ID.
/v1/lists
제재 목록 메타데이터 및 마지막 업데이트를 확인하세요.
Response
{
"success": true,
"data": [
{"code": "ofac_sdn", "name": "OFAC SDN", "count": 12450},
{"code": "eu", "name": "EU Consolidated", "count": 8200},
{"code": "un", "name": "UN Security Council", "count": 1850},
{"code": "uk_hmt", "name": "UK HMT", "count": 4100},
{"code": "ca_sema", "name": "Canada SEMA", "count": 2300},
{"code": "au_dfat", "name": "Australia DFAT", "count": 1100},
{"code": "world_bank", "name": "World Bank", "count": 950},
{"code": "ofac_cons", "name": "OFAC Consolidated", "count": 1602}
]
}
/v1/lists/{list}/updates
Get recent updates for a specific sanctions list (e.g. ofac_sdn, eu).
/v1/favorites
이름을 저장하여 자동 재심사합니다.
/v1/favorites
Add an entity to your favorites watchlist.
/v1/favorites/{id}
Remove an entity from your favorites.
/v1/alerts
Retrieve your screening alerts and notifications.
/v1/webhooks
List your configured webhooks.
/v1/webhooks
실시간 알림을 위한 웹훅을 등록하세요.
Request
{
"url": "https://yoursite.com/webhook",
"events": ["screening.match", "list.updated"]
}
/v1/webhooks/{id}
Update a webhook configuration.
/v1/webhooks/{id}
Delete a webhook.
/v1/webhooks/{id}/test
Send a test event to your webhook endpoint.
Error Codes
| Code | Status | Description |
|---|---|---|
| 200 | OK | Request successful |
| 201 | Created | Resource created successfully |
| 400 | Bad Request | Invalid parameters or missing required fields |
| 401 | Unauthorized | Missing or invalid API key |
| 403 | Forbidden | Insufficient plan or credits exhausted |
| 404 | Not Found | Resource not found |
| 422 | Unprocessable | Validation error |
| 429 | Too Many Requests | Rate limit exceeded |
Error responses include a JSON body: {"success": false, "message": "Error description"}
요청 제한
| Plan | Requests | Screenings |
|---|---|---|
| Free | 10 req/min | 10/month |
| Pro ($29/mo) | 100 req/min | 100/month |
| Business ($99/mo) | 1,000 req/min | Unlimited |
Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Sanctions Lists Coverage
32,500+ entities across 8 global sanctions lists:
OFAC SDN
OFAC Consolidated
EU Consolidated
UN Security Council
UK HMT
Canada SEMA
Australia DFAT
World Bank
빠른 시작
cURL
curl -X POST https://isarud.com/api/v1/screen \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Ali Khamenei", "type": "individual"}'
Python
import requests
r = requests.post("https://isarud.com/api/v1/screen",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"name": "Ali Khamenei", "type": "individual"})
print(r.json())
Node.js
const res = await fetch("https://isarud.com/api/v1/screen", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({ name: "Ali Khamenei", type: "individual" })
});
console.log(await res.json());
PHP (Laravel)
$response = Http::withHeaders([
'Authorization' => 'Bearer YOUR_API_KEY',
])->post('https://isarud.com/api/v1/screen', [
'name' => 'Ali Khamenei',
'type' => 'individual',
]);
return $response->json();
WooCommerce & Shopify Integration
No API coding required — use our plugins for automatic order screening and marketplace sync.