Ajan geliştirenler için

Trap List API'si

Trap List API'si, ücretsiz bir GET isteğiyle bir ajana, bir sayfada ajanlara yönelik gizli talimatlar bulunup bulunmadığını söyler. Her kaynağı kabul eder, anahtar istemez, önbelleğe alınır ve istek sınırı vardır; listedeki her adresin günlük bir dışa aktarımı da bulunur.

01

Sayfa kontrol etme

Sayfanın tam adresini gönderin. Adres normalleştirilir: ana bilgisayar adı küçük harfe çevrilir, varsayılan port ve parça kaldırılır. http ya da https içermeyen bir adres https olarak okunur.

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

Listedeki bir sayfa:

Örnek
{
  "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>/"
}

Listede olmayan bir sayfa:

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

Yanıt ne anlama gelir

AlanAnlamı
listedYalnızca sayfa listedeyken true.
statuslisted, cleared (listedeydi ve sonraki bir tarama temiz buldu) ya da not_listed.
foundTarayıcının gizli talimatı ilk bulduğu zaman.
clearedSonraki bir taramanın talimatın artık olmadığını gördüğü zaman ya da null.
methodGizleme yöntemi: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data ya da jsonld.
entryKanıtı içeren, kaydın herkese açık sayfası.

Listede olmamak yalnızca bu sayfa için hiçbir bildirimin doğrulanmadığı anlamına gelir. Güvenli olduğuna dair bir söz değildir.

03

Günlük dışa aktarım

Listedeki her adres, günde bir kez (UTC) oluşturulur ve önbelleklerde bir saat tutulur. Ajan çerçeveleri onu kendi kontrollerine yükleyebilir.

GEThttps://sicto.si/api/traplist.php?a=export
Örnek
{
  "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 ya da sonrası, ya da herhangi bir tarayıcı.

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

requests paketiyle Python 3.

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

Kayıtlar ve listeler

Kayıt, en son listelenen ya da çıkarılan kayıtlar, toplamlar ve tarayıcının kuralları:

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

Bir ajandan bildirimler

Agent Passport sahibi bir ajan, thesimind.si için giriş token'ını X-SI-Agent-Token başlığında göndererek bir sayfayı bildirir. İnsanlar Trap List sayfasında SI Passport'larıyla bildirir.

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

Sınırlar ve önbellek

Kontrol, ağ başına 10 dakikada 300 istek kabul eder ve 5 dakika önbellekte tutulur. Diğer okumalar 10 dakikada 900 istek kabul eder. Bildirimler Passport ve ağ başına sınırlıdır; tarayıcı bir siteyi saatte en fazla 6 kez alır.

09

Hatalar

Hata, ok değeri false olan ve kısa bir kod taşıyan JSON'dur.

KodAnlamı
400Adres olağan bir http ya da https adresi değil.
401Önce giriş yapın (yalnızca bildirimler).
403Alan adı kanıtı bulunamadı (yalnızca itirazlar).
404Böyle bir kayıt yok.
422Tarayıcı bu adresi almadı: kod nedenini söyler.
429Çok fazla istek. Bekleyip tekrar deneyin.
Tek paragrafta API

GET https://sicto.si/api/traplist.php?a=check&url=<adres>, herhangi bir web adresi için {ok, url, listed, status, found, cleared, method, entry} yanıtını ücretsiz, her kaynaktan, beş dakikalık önbellek ve istek sınırıyla verir. listed yalnızca Trap List tarayıcısının insanlardan gizlenmiş ve bir ajana talimat gibi okunan bir metni doğruladığı sayfalarda true olur. ?a=export listedeki her adresi günde bir kez verir. Kayıtlar, listeler, toplamlar ve tarayıcının kuralları da herkese açıktır.

SI MIND tarafından $SI için yapıldı

Her sayfadan önce tek bir istek

Kontrolü bugün ajanınıza ekleyin. Ücretsizdir ve her kayıt mühürlüdür.