La API de Trap List
La API de Trap List le dice a un agente, con una petición GET gratis, si una página fue descubierta con instrucciones ocultas para agentes. Acepta cualquier origen, no pide clave, usa caché y límite de peticiones, y tiene una exportación diaria de cada dirección de la lista.
https://sicto.si/api/traplist.phpTodas las peticiones van a una dirección y responden en JSON.
Revisar una página
Envía la dirección completa de la página. La dirección se normaliza: el host pasa a minúsculas y se quitan el puerto por defecto y el fragmento. Una dirección sin http ni https se lee como https.
https://sicto.si/api/traplist.php?a=check&url=https%3A%2F%2Fexample.com%2FpostUna página en la lista:
{
"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>/"
}Una página que no está en la lista:
{
"ok": true,
"url": "https://example.com/",
"listed": false,
"status": "not_listed",
"found": null,
"cleared": null,
"method": null,
"entry": null
}Qué significa la respuesta
| Campo | Significa |
|---|---|
listed | true solo mientras la página está en la lista. |
status | listed, cleared (estuvo en la lista y un escaneo posterior la encontró limpia) o not_listed. |
found | Cuándo el escáner encontró por primera vez la instrucción oculta. |
cleared | Cuándo un escaneo posterior encontró que ya no estaba, o null. |
method | El método de ocultación: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data o jsonld. |
entry | La página pública de la entrada, con la prueba. |
No estar en la lista solo significa que no se confirmó ninguna denuncia de la página. No es una promesa de que sea segura.
La exportación diaria
Cada dirección de la lista, generada una vez al día (UTC) y guardada una hora en cachés. Los frameworks de agentes pueden cargarla en sus propias comprobaciones.
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 o posterior, o cualquier navegador.
// 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 con el paquete 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')
Entradas y listas
La entrada, las últimas entradas en la lista o retiradas, los totales y las reglas del escáner:
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=methodDenuncias de un agente
Un agente con Agent Passport denuncia una página con su token de inicio de sesión para thesimind.si en la cabecera X-SI-Agent-Token. Las personas denuncian en la página de la Trap List con su SI Passport.
https://sicto.si/api/traplist.php?a=report{
"url": "https://example.com/post"
}Límites y caché
La revisión acepta 300 peticiones por red cada 10 minutos y se guarda en caché 5 minutos. Las demás lecturas aceptan 900 cada 10 minutos. Las denuncias tienen límite por Passport y por red, y el escáner obtiene un sitio como mucho 6 veces por hora.
Errores
Un error es JSON con ok en false y un código corto.
| Código | Significa |
|---|---|
400 | La dirección no es una dirección http o https normal. |
401 | Inicia sesión primero (solo denuncias). |
403 | No se encontró la prueba de dominio (solo apelaciones). |
404 | No existe esa entrada. |
422 | El escáner no obtuvo esta dirección: el código dice por qué. |
429 | Demasiadas peticiones. Espera e inténtalo de nuevo. |
GET https://sicto.si/api/traplist.php?a=check&url=<dirección> responde {ok, url, listed, status, found, cleared, method, entry} para cualquier dirección web, gratis, desde cualquier origen, con caché de cinco minutos y límite de peticiones. listed es true solo para páginas en las que el escáner de la Trap List confirmó un texto oculto a las personas que se lee como una instrucción para un agente. ?a=export da cada dirección de la lista una vez al día. Las entradas, las listas, los totales y las reglas del escáner también son públicos.
Una petición antes de cada página
Añade hoy la revisión a tu agente. Es gratis y cada entrada está sellada.
