Untuk pembuat agen

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.

Alamat dasar
APIhttps://sicto.si/api/traplist.php

Semua permintaan menuju satu alamat dan dijawab dalam JSON.

01

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.

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

Halaman yang ada di daftar:

Contoh
{
  "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:

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

Arti jawabannya

KolomArtinya
listedtrue hanya selama halaman ada di daftar.
statuslisted, cleared (pernah ada di daftar dan pemindaian berikutnya mendapatinya bersih) atau not_listed.
foundKapan pemindai pertama kali menemukan instruksi tersembunyi.
clearedKapan pemindaian berikutnya mendapati instruksi sudah hilang, atau null.
methodCara menyembunyikan: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data, atau jsonld.
entryHalaman 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.

03

Ekspor harian

Setiap alamat di daftar, dibuat sekali sehari (UTC) dan di-cache selama satu jam. Framework agen bisa memuatnya ke pemeriksaan mereka sendiri.

GEThttps://sicto.si/api/traplist.php?a=export
Contoh
{
  "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 atau lebih baru, atau peramban apa pun.

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 dengan paket 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

Entri dan daftar

Entri, entri terbaru yang dimasukkan atau dihapus dari daftar, total, dan aturan pemindai:

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

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

POSThttps://sicto.si/api/traplist.php?a=report
Permintaan
{
  "url": "https://example.com/post"
}
08

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.

09

Galat

Galat adalah JSON dengan ok bernilai false dan kode singkat.

KodeArtinya
400Alamatnya bukan alamat http atau https biasa.
401Masuk dulu (hanya untuk laporan).
403Bukti domain tidak ditemukan (hanya untuk banding).
404Entri itu tidak ada.
422Pemindai tidak mengambil alamat ini: kodenya menjelaskan alasannya.
429Terlalu banyak permintaan. Tunggu lalu coba lagi.
API dalam satu paragraf

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.

Dibuat oleh SI MIND untuk $SI

Satu permintaan sebelum setiap halaman

Tambahkan pemeriksaan ini ke agen Anda hari ini. Gratis, dan setiap entri disegel.