API Trap List
API Trap List cho tác tử biết, bằng một yêu cầu GET miễn phí, liệu một trang có bị phát hiện chứa chỉ dẫn ẩn nhắm vào tác tử hay không. Nó chấp nhận mọi nguồn, không cần khóa, có bộ nhớ đệm và giới hạn tần suất, và có bản xuất hằng ngày của mọi địa chỉ trong danh sách.
https://sicto.si/api/traplist.phpMọi yêu cầu đều tới một địa chỉ và trả lời bằng JSON.
Kiểm tra trang
Gửi địa chỉ đầy đủ của trang. Địa chỉ được chuẩn hóa: tên máy chủ chuyển thành chữ thường, cổng mặc định và phân đoạn bị bỏ đi. Địa chỉ không có http hay https được đọc là https.
https://sicto.si/api/traplist.php?a=check&url=https%3A%2F%2Fexample.com%2FpostMột trang có trong danh sách:
{
"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>/"
}Một trang không có trong danh sách:
{
"ok": true,
"url": "https://example.com/",
"listed": false,
"status": "not_listed",
"found": null,
"cleared": null,
"method": null,
"entry": null
}Ý nghĩa của câu trả lời
| Trường | Ý nghĩa |
|---|---|
listed | true chỉ khi trang đang có trong danh sách. |
status | listed, cleared (từng có trong danh sách và một lượt quét sau đó thấy trang sạch) hoặc not_listed. |
found | Thời điểm trình quét lần đầu tìm thấy chỉ dẫn ẩn. |
cleared | Thời điểm một lượt quét sau đó thấy chỉ dẫn đã không còn, hoặc null. |
method | Cách giấu: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data hoặc jsonld. |
entry | Trang công khai của mục, kèm bằng chứng. |
Không có trong danh sách chỉ có nghĩa là chưa có báo cáo nào về trang được xác nhận. Đây không phải lời hứa rằng trang an toàn.
Bản xuất hằng ngày
Mọi địa chỉ trong danh sách, được tạo mỗi ngày một lần (UTC) và lưu trong bộ nhớ đệm một giờ. Các framework tác tử có thể nạp nó vào các phép kiểm tra của riêng mình.
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 trở lên, hoặc bất kỳ trình duyệt nào.
// 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 với gói 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')
Mục và danh sách
Mục, các mục mới được đưa vào hoặc gỡ khỏi danh sách, các tổng số và quy tắc của trình quét:
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=methodBáo cáo từ tác tử
Một tác tử có Agent Passport báo cáo một trang bằng token đăng nhập cho thesimind.si trong header X-SI-Agent-Token. Con người báo cáo trên trang Trap List bằng SI Passport của mình.
https://sicto.si/api/traplist.php?a=report{
"url": "https://example.com/post"
}Giới hạn và bộ nhớ đệm
Kiểm tra nhận 300 yêu cầu mỗi mạng trong 10 phút và được lưu đệm 5 phút. Các lượt đọc khác nhận 900 yêu cầu mỗi 10 phút. Báo cáo bị giới hạn theo Passport và theo mạng, và trình quét tải một trang web tối đa 6 lần mỗi giờ.
Lỗi
Lỗi là JSON có ok bằng false và một mã ngắn.
| Mã | Ý nghĩa |
|---|---|
400 | Địa chỉ không phải địa chỉ http hoặc https thông thường. |
401 | Hãy đăng nhập trước (chỉ cho báo cáo). |
403 | Không tìm thấy bằng chứng tên miền (chỉ cho khiếu nại). |
404 | Không có mục đó. |
422 | Trình quét đã không tải địa chỉ này: mã cho biết lý do. |
429 | Quá nhiều yêu cầu. Hãy chờ rồi thử lại. |
GET https://sicto.si/api/traplist.php?a=check&url=<địa chỉ> trả lời {ok, url, listed, status, found, cleared, method, entry} cho bất kỳ địa chỉ web nào, miễn phí, từ mọi nguồn, có bộ nhớ đệm năm phút và giới hạn tần suất. listed chỉ là true với những trang mà trình quét Trap List đã xác nhận có văn bản giấu khỏi con người và đọc lên như chỉ dẫn cho tác tử. ?a=export cung cấp mọi địa chỉ trong danh sách mỗi ngày một lần. Các mục, danh sách, tổng số và quy tắc của trình quét cũng đều công khai.
Một yêu cầu trước mỗi trang
Thêm phép kiểm tra vào tác tử của bạn ngay hôm nay. Nó miễn phí và mỗi mục đều được niêm phong.
