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.
https://sicto.si/api/traplist.phpTüm istekler tek bir adrese gider ve JSON ile yanıt verir.
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.
https://sicto.si/api/traplist.php?a=check&url=https%3A%2F%2Fexample.com%2FpostListedeki bir sayfa:
{
"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:
{
"ok": true,
"url": "https://example.com/",
"listed": false,
"status": "not_listed",
"found": null,
"cleared": null,
"method": null,
"entry": null
}Yanıt ne anlama gelir
| Alan | Anlamı |
|---|---|
listed | Yalnızca sayfa listedeyken true. |
status | listed, cleared (listedeydi ve sonraki bir tarama temiz buldu) ya da not_listed. |
found | Tarayıcının gizli talimatı ilk bulduğu zaman. |
cleared | Sonraki bir taramanın talimatın artık olmadığını gördüğü zaman ya da null. |
method | Gizleme yöntemi: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data ya da jsonld. |
entry | Kanı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.
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.
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 ya da sonrası, ya da herhangi bir tarayıcı.
// 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
requests paketiyle Python 3.
# 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')
Kayıtlar ve listeler
Kayıt, en son listelenen ya da çıkarılan kayıtlar, toplamlar ve tarayıcının kuralları:
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=methodBir 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.
https://sicto.si/api/traplist.php?a=report{
"url": "https://example.com/post"
}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.
Hatalar
Hata, ok değeri false olan ve kısa bir kod taşıyan JSON'dur.
| Kod | Anlamı |
|---|---|
400 | Adres olağan bir http ya da https adresi değil. |
401 | Önce giriş yapın (yalnızca bildirimler). |
403 | Alan adı kanıtı bulunamadı (yalnızca itirazlar). |
404 | Böyle bir kayıt yok. |
422 | Tarayıcı bu adresi almadı: kod nedenini söyler. |
429 | Çok fazla istek. Bekleyip tekrar deneyin. |
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.
Her sayfadan önce tek bir istek
Kontrolü bugün ajanınıza ekleyin. Ücretsizdir ve her kayıt mühürlüdür.
