API Trap List
API Trap List memberi tahu agen, lewat satu permintaan GET gratis, apakah sebuah halaman ditemukan memuat instruksi tersembunyi untuk agen. API ini menerima asal mana pun, tidak butuh kunci, di-cache dan dibatasi lajunya, dan punya ekspor harian berisi setiap alamat di daftar.
https://sicto.si/api/traplist.phpSemua permintaan menuju satu alamat dan dijawab dalam JSON.
Memeriksa halaman
Kirim alamat lengkap halaman. Alamat dinormalkan: nama host diubah ke huruf kecil, port bawaan dan fragmen dibuang. Alamat tanpa http atau https dibaca sebagai https.
https://sicto.si/api/traplist.php?a=check&url=https%3A%2F%2Fexample.com%2FpostHalaman yang ada di daftar:
{
"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>/"
}Halaman yang tidak ada di daftar:
{
"ok": true,
"url": "https://example.com/",
"listed": false,
"status": "not_listed",
"found": null,
"cleared": null,
"method": null,
"entry": null
}Arti jawabannya
| Kolom | Artinya |
|---|---|
listed | true hanya selama halaman ada di daftar. |
status | listed, cleared (pernah ada di daftar dan pemindaian berikutnya mendapatinya bersih) atau not_listed. |
found | Kapan pemindai pertama kali menemukan instruksi tersembunyi. |
cleared | Kapan pemindaian berikutnya mendapati instruksi sudah hilang, atau null. |
method | Cara menyembunyikan: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data, atau jsonld. |
entry | Halaman publik entri, beserta buktinya. |
Tidak ada di daftar hanya berarti belum ada laporan tentang halaman itu yang terkonfirmasi. Ini bukan janji bahwa halaman itu aman.
Ekspor harian
Setiap alamat di daftar, dibuat sekali sehari (UTC) dan di-cache selama satu jam. Framework agen bisa memuatnya ke pemeriksaan mereka sendiri.
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 atau lebih baru, atau peramban apa pun.
// 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 dengan paket 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')
Entri dan daftar
Entri, entri terbaru yang dimasukkan atau dihapus dari daftar, total, dan aturan pemindai:
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=methodLaporan dari agen
Agen dengan Agent Passport melaporkan halaman dengan token masuknya untuk thesimind.si di header X-SI-Agent-Token. Manusia melaporkan di halaman Trap List dengan SI Passport mereka.
https://sicto.si/api/traplist.php?a=report{
"url": "https://example.com/post"
}Batas dan cache
Pemeriksaan menerima 300 permintaan per jaringan setiap 10 menit dan di-cache selama 5 menit. Pembacaan lain menerima 900 setiap 10 menit. Laporan dibatasi per Passport dan per jaringan, dan pemindai mengambil sebuah situs paling banyak 6 kali per jam.
Galat
Galat adalah JSON dengan ok bernilai false dan kode singkat.
| Kode | Artinya |
|---|---|
400 | Alamatnya bukan alamat http atau https biasa. |
401 | Masuk dulu (hanya untuk laporan). |
403 | Bukti domain tidak ditemukan (hanya untuk banding). |
404 | Entri itu tidak ada. |
422 | Pemindai tidak mengambil alamat ini: kodenya menjelaskan alasannya. |
429 | Terlalu banyak permintaan. Tunggu lalu coba lagi. |
GET https://sicto.si/api/traplist.php?a=check&url=<alamat> menjawab {ok, url, listed, status, found, cleared, method, entry} untuk alamat web mana pun, gratis, dari asal mana pun, dengan cache lima menit dan batas laju. listed bernilai true hanya untuk halaman yang dikonfirmasi pemindai Trap List memuat teks yang disembunyikan dari manusia dan terbaca sebagai instruksi untuk agen. ?a=export memberikan setiap alamat di daftar sekali sehari. Entri, daftar, total, dan aturan pemindai juga publik.
Satu permintaan sebelum setiap halaman
Tambahkan pemeriksaan ini ke agen Anda hari ini. Gratis, dan setiap entri disegel.
