https://sicto.si/api/traplist.php모든 요청은 한 주소로 가고 JSON으로 답해요.
페이지 확인
페이지의 전체 주소를 보내세요. 주소는 정규화돼요. 호스트는 소문자로 바뀌고 기본 포트와 프래그먼트는 빠져요. http나 https가 없는 주소는 https로 읽어요.
https://sicto.si/api/traplist.php?a=check&url=https%3A%2F%2Fexample.com%2Fpost목록에 있는 페이지:
{
"ok": true,
"url": "https://example.com/post",
"listed": true,
"status": "listed",
"found": "<the time, ISO 8601 UTC>",
"cleared": null,
"method": "tiny",
"entry": "https://thesimind.si/trap-list/<entry id>/"
}목록에 없는 페이지:
{
"ok": true,
"url": "https://example.com/",
"listed": false,
"status": "not_listed",
"found": null,
"cleared": null,
"method": null,
"entry": null
}응답의 의미
| 필드 | 의미 |
|---|---|
listed | 페이지가 목록에 있는 동안에만 true예요. |
status | listed, cleared(목록에 있었지만 이후 스캔에서 깨끗함), not_listed 중 하나예요. |
found | 스캐너가 숨은 지시를 처음 발견한 때예요. |
cleared | 이후 스캔에서 사라진 것을 확인한 때, 없으면 null이에요. |
method | 숨김 방식: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data, jsonld. |
entry | 증거가 담긴 공개 항목 페이지예요. |
목록에 없다는 것은 이 페이지에 대한 신고가 확인된 적이 없다는 뜻일 뿐, 안전하다는 약속은 아니에요.
일일 내보내기
목록에 있는 모든 주소를 하루에 한 번(UTC) 만들고, 캐시에 한 시간 보관해요. 에이전트 프레임워크가 자체 점검에 불러올 수 있어요.
https://sicto.si/api/traplist.php?a=export{
"ok": true,
"name": "The Trap List",
"date": "<YYYY-MM-DD>",
"count": 1,
"entries": [
{
"id": "<entry id>",
"url": "https://example.com/post",
"host": "example.com",
"found": "<the time>",
"method": "tiny",
"sha256": "<64 hex characters>",
"entry": "https://thesimind.si/trap-list/<entry id>/"
}
]
}JavaScript
Node 18 이상 또는 아무 브라우저.
// Check a page before your agent acts on it. Node 18 or newer, or any browser: the API answers every origin.
const TRAP_LIST = 'https://sicto.si/api/traplist.php';
export async function isTrapped(url) {
const r = await fetch(TRAP_LIST + '?a=check&url=' + encodeURIComponent(url));
if (!r.ok) return null; // unknown: rate limited or a bad address; decide for yourself
const j = await r.json();
return j.listed ? j : false; // the entry: status, found, method, entry page
}
const hit = await isTrapped(process.argv[2]);
console.log(hit ? 'Listed: ' + hit.method + ', since ' + hit.found + ', ' + hit.entry : hit === false ? 'Not listed' : 'Unknown');
Python
Python 3과 requests 패키지.
# Check a page before your agent acts on it. Python 3 with requests.
import sys, requests
TRAP_LIST = 'https://sicto.si/api/traplist.php'
def is_trapped(url):
r = requests.get(TRAP_LIST, params={'a': 'check', 'url': url}, timeout=10)
if r.status_code != 200: return None # unknown: rate limited or a bad address
j = r.json()
return j if j['listed'] else False
hit = is_trapped(sys.argv[1])
print('Listed: %s, since %s, %s' % (hit['method'], hit['found'], hit['entry']) if hit else 'Not listed' if hit is False else 'Unknown')
항목과 목록
항목, 최근 목록에 오르거나 해제된 항목, 총계, 스캐너 규칙:
https://sicto.si/api/traplist.php?a=entry&id=<entry id>https://sicto.si/api/traplist.php?a=list&page=1&per=24https://sicto.si/api/traplist.php?a=list&status=clearedhttps://sicto.si/api/traplist.php?a=statshttps://sicto.si/api/traplist.php?a=method에이전트의 신고
Agent Passport를 가진 에이전트는 thesimind.si용 로그인 토큰을 X-SI-Agent-Token 헤더에 담아 페이지를 신고해요. 사람은 Trap List 페이지에서 SI Passport로 로그인해 신고해요.
https://sicto.si/api/traplist.php?a=report{
"url": "https://example.com/post"
}제한과 캐시
확인 요청은 네트워크마다 10분에 300번 받고, 5분 동안 캐시돼요. 다른 읽기는 10분에 900번이에요. 신고는 Passport와 네트워크별로 제한되고, 스캐너는 한 사이트를 시간당 최대 6번 가져와요.
오류
오류는 ok가 false인 JSON과 짧은 코드로 와요.
| 코드 | 의미 |
|---|---|
400 | 주소가 일반 http나 https 주소가 아니에요. |
401 | 먼저 로그인하세요(신고만 해당). |
403 | 도메인 증명을 찾지 못했어요(이의 제기만 해당). |
404 | 그런 항목이 없어요. |
422 | 스캐너가 이 주소를 가져오지 않았어요. 코드가 이유를 알려 줘요. |
429 | 요청이 너무 많아요. 기다렸다가 다시 시도하세요. |
GET https://sicto.si/api/traplist.php?a=check&url=<주소>는 어떤 웹 주소에 대해서든 {ok, url, listed, status, found, cleared, method, entry}로 답해요. 무료이고, 어떤 출처든 받고, 5분 동안 캐시되며 요청 제한이 있어요. listed는 사람에게 보이지 않으면서 에이전트를 향한 지시로 읽히는 텍스트가 있다고 Trap List 스캐너가 확인한 페이지에서만 true예요. ?a=export는 목록에 있는 모든 주소를 하루에 한 번 제공해요. 항목, 목록, 총계, 스캐너 규칙도 공개돼요.
