10분 안에 SanctionSnap API로 제재 검사를 구축하세요

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴

대상자

• 개발자 및 DevOps 엔지니어
• 중간 난이도 (HTTP 요청, API 인증, JSON 처리 기초 지식 필요)

핵심 요약

• HTTP 요청으로 전 세계 제재 목록 검사 가능 (curl, requests, node-fetch 지원)
• API 키 생성 및 사용: X-API-Key 헤더로 인증, 무료 계획 250회/월 제공
• 명확한 응답 구조: id, source, similarity_score, program 등 핵심 필드 포함

섹션별 세부 요약

1. API 등록 및 키 생성

• sanctionsnap.com에서 계정 생성 후 API 키 생성
• Dashboard → API Keys → “Create key” 경로 제공
• 무료 계획: 월 250회 요청 가능

2. 단일 이름 검사 예시

• curl 명령어로 JSON 데이터 전송:

```bash

curl -X POST \

-H "X-API-Key: YOUR_KEY" \

-H "Content-Type: application/json" \

-d '{"name":"Vladimir Putin"}' | jq

```

• 응답 예시:

```json

{

"id": 12345,

"source": "ofac",

"name": "PUTIN, Vladimir Vladimirovich",

"similarity_score": 0.95,

"program": "RUSSIA-EO13661"

}

```

3. 일괄 검사 (CSV/XLSX 업로드)

• Web Console에서 CSV/XLSX 파일 업로드
• 일괄 검사 기능 제공, 복잡한 스프레드시트 파싱 필요 없음

4. Python 및 JavaScript 예제

• Python: requests 라이브러리 사용

```python

import requests

API_KEY = "YOUR_KEY"

payload = {"name": "Ali Akbar Salehi"}

headers = {"X-API-Key": API_KEY}

res = requests.post(url, json=payload, headers=headers)

```

• JavaScript: node-fetch 모듈 사용

```javascript

import fetch from "node-fetch";

const res = await fetch("URL", {

method: "POST",

headers: {

"Content-Type": "application/json",

"X-API-Key": process.env.SNAP_KEY

},

body: JSON.stringify({ name: "Kim Jong Un" })

});

```

결론

• 제재 목록 검사 시 CSV/스프레드시트 대신 API 엔드포인트 사용
• 무료 계획의 250회/월 제한을 고려해 요청 수 관리 필요
• X-API-Key 인증 방식은 보안 및 단순성 측면에서 추천