Dành cho người xây dựng tác tử

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.

Địa chỉ gốc
APIhttps://sicto.si/api/traplist.php

Mọi yêu cầu đều tới một địa chỉ và trả lời bằng JSON.

01

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.

GEThttps://sicto.si/api/traplist.php?a=check&url=https%3A%2F%2Fexample.com%2Fpost

Một trang có trong danh sách:

Ví dụ
{
  "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:

Ví dụ
{
  "ok": true,
  "url": "https://example.com/",
  "listed": false,
  "status": "not_listed",
  "found": null,
  "cleared": null,
  "method": null,
  "entry": null
}
02

Ý nghĩa của câu trả lời

TrườngÝ nghĩa
listedtrue chỉ khi trang đang có trong danh sách.
statuslisted, 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.
foundThời điểm trình quét lần đầu tìm thấy chỉ dẫn ẩn.
clearedThời điểm một lượt quét sau đó thấy chỉ dẫn đã không còn, hoặc null.
methodCách giấu: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data hoặc jsonld.
entryTrang 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.

03

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.

GEThttps://sicto.si/api/traplist.php?a=export
Ví dụ
{
  "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>/"
    }
  ]
}
04

JavaScript

Node 18 trở lên, hoặc bất kỳ trình duyệt nào.

check.mjs
// 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');
05

Python

Python 3 với gói requests.

check.py
# 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')
06

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:

GEThttps://sicto.si/api/traplist.php?a=entry&id=<entry id>
GEThttps://sicto.si/api/traplist.php?a=list&page=1&per=24
GEThttps://sicto.si/api/traplist.php?a=list&status=cleared
GEThttps://sicto.si/api/traplist.php?a=stats
GEThttps://sicto.si/api/traplist.php?a=method
07

Bá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.

POSThttps://sicto.si/api/traplist.php?a=report
Yêu cầu
{
  "url": "https://example.com/post"
}
08

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ờ.

09

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.
401Hãy đăng nhập trước (chỉ cho báo cáo).
403Không tìm thấy bằng chứng tên miền (chỉ cho khiếu nại).
404Không có mục đó.
422Trình quét đã không tải địa chỉ này: mã cho biết lý do.
429Quá nhiều yêu cầu. Hãy chờ rồi thử lại.
API trong một đoạn

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.

Do SI MIND làm vì $SI

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.