← Back to docs

Tools API Dokumentation

Language: SV | EN | SV

Tools API Dokumentation

Välkommen till dokumentationen för Tools.

Denna dokumentation är skriven som en användarguide för utvecklare som integrerar mot våra publika API:er och webbgränssnitt. Den täcker autentisering, begärandeformat, svarsschemat, kodexempel och tokenanvändning.


Stöd & medlemsnivåer

Stöd Tools

Bakgrundsguide till den publika Ko-fi-sidan, inklusive vad som redan finns i plattformen idag, varför driftkostnaden växer och hur de sex stödnivåerna är tänkta att förstås.

  • Stödsida: https://ko-fi.com/tornevall/
  • Innehåll: projektets riktning, kostnadsbild, supporter-gränser, lättlästa beskrivningar av alla nuvarande medlemsnivåer och tabellen för AI Budget

Läs guiden Stöd Tools →


Juridik

Integritet och dataanvandning: Se Integritetspolicy →

Generella plattformsvillkor: Se Användarvillkor →


API Referens

IRC Memory Lane - Loggsök API

Sök och hämta IRC-kanallogngar med avancerad filtrering. Perfekt för att integrera loggdata i andra applikationer.

  • Autentisering: API Key Bearer-token
  • Rate Limiting: 60 förfrågningar/minut
  • Funktioner: Fulltextsökning, kanalfiltrering, datumintervall, användarnamn

Se IRC Log API-dokumentation →

Snabbstartsguide (inkluderar setup, grund- och avancerade exempel): IRC Memory Lane API Guide →


RSS Feed Analytics - Kategorianalys API

Generera AI-drivna analyser av RSS-feeds per kategori. ChatGPT identifierar teman, narrativmönster och beteendeutvecklingar i aggregerat nyhetsinnehål.

  • Autentisering: Websession + permission:rss
  • Rate Limiting: 20 förfrågningar/minut (generering)
  • Cachning: Automatisk deduplicering efter innehålssignatur

Se RSS Analytics API-dokumentation →


SMS Leverans API

Skicka SMS-meddelanden med callback-spårning och leveransstatusuppdateringar.

  • Autentisering: API Key eller Bearer-token
  • Rate Limiting: 300 förfrågningar/minut
  • Funktioner: Mallmeddelanden, leveransspårning, felhantering

Se SMS API Referens →

SMS Callback-svar (webhook-svar): SMS Prefix Callback Guide →


Marvel MCU Timeline API

Sök och hämta Marvel Cinematic Universe-data med kronologisk ordning och IMDB-integration.

  • Autentisering: Publik (ingen autentisering krävs)
  • Rate Limiting: 300 förfrågningar/minut
  • Funktioner: Tidslinjsökning, fassökning, relaterat innehål

Se MCU API-dokumentation →


DNS Zone List API

Upptäck och fråga BIND DNS-zoner, hämta zonmetadata och få åtkomst till DNS-poster.

  • Autentisering: API Key Bearer-token
  • Rate Limiting: 60 förfrågningar/minut
  • Funktioner: Zondiscovery, filvägar, TSIG-nycklar, posteranalys

Se DNS API-dokumentation →


DNSBL / FraudBL API

Realtidsblockeringslista-frågor med bitmaskstöd, DNS-först-publicering, handelsdata-spegling och DMARC-intagning för DNSBL-granskningskön.

  • Autentisering: API Key eller Bearer-token
  • Rate Limiting: 9000 förfrågningar/minut
  • Funktioner: Bitmaskuppslagningar, vitlistfrågor, dataöverföring, DMARC-uppladdning och granskningsflöde

Se DNSBL/FraudBL API-dokumentation →


DNSBL DMARC-granskningskö

Admininriktat intagnings- och granskningsflöde för DMARC-aggregate-rapporter innan en rapporterad IP-adress eventuellt publiceras till DNSBL.

  • Åtkomst: /admin/dnsbl/dmarc (admin-UI för granskning), POST /api/dnsbl/dmarc/report (intagningsendpoint)
  • Funktioner: DMARC-uppladdning, dubblettsäkert intag, lagring av normaliserad XML, granskning per käll-IP, publicering som spam eller spam+fraud

Se dokumentation för DNSBL DMARC →


Webbgränssnitt Dokumentation

OpenAI / AI-motor

Intern AI-motordashboard för hantering av prompt-profiler, testning av prompts och övervakning av API-användning.

  • Åtkomst: /admin/openai (kräver permission:openai.manage)
  • Funktioner: Profilhantering, modellval, tokenbudgetar, hastighetsbegränsning, testgränssnitt

Se OpenAI-motor dokumentation →


Registrering och kontogranskning

Den publika registreringsflödet och adminvyerna för användare visar nu också en liten discovery-signal så att sajtägaren kan se hur nya personer hittade till Tools.

  • Åtkomst: /register för nya konton, /users och /users/{user}/edit för adminkontroll
  • Funktioner: valfri fråga Where did you hear about us? vid registrering, skrivskyddad synlighet i admin tillsammans med registrerings-IP, samt med i e-postnotisen om nytt konto

Användarutskick och säkra felsidor

Adminbegränsat flöde för servicemeddelanden till valda grupper av Tools-användare, plus säkrare generiska browserfelsidor.

  • Åtkomst: /users/mailout från användarhanteringen; enbart administratörer
  • Funktioner: mottagarräkning, AI-hjälp för utkast, preview, dry run, testmail till dig själv, supportadress som avsändare, obligatorisk bekräftelsefras för riktiga utskick, generiska icke-läckande felsidor på publika Tools-hostar

Se dokumentation för användarutskick →


API IP whitelist

Adminsida för att underhålla betrodda IPv4-adresser och CIDR-ranges som kan få bypassa normal autentisering på stödda API-rutter.

  • Åtkomst: /admin/security/api-ip-whitelist (admin-webbsession)
  • Funktioner: lägga till, aktivera/inaktivera, redigera och ta bort whitelist-poster; valfri endpoint-scope per post

vBulletin-registrering & extern gruppadministration

Tools-styrt registreringsflöde för vBulletin-communityn där invite-/granskningsstatus lagras i Tools medan själva forumkontot fortfarande lever i vBulletin.

  • Åtkomst: /admin/security/vbulletin (kräver vbulletin.manage), publika registreringssidor under /vbulletin/onboarding/*
  • Funktioner: registreringskonfigurationer, återanvändbara invite-/referrallänkar plus engångsnycklar, publik start + statussida, granskningskö, scoped grant/revoke av forumgrupper, AJAX-användarsökning, hostat welcome/info-script, färdiga medlemswidgets för vBulletin HTML-block och tydligare auditlogg för registreringsaktivitet

Se dokumentation för vBulletin-registrering →

Se kort changelog för registreringen →

Se frontend-guiden för invite-complete-hooken →


Password Manager

Inloggningsstyrd personlig vault-grund för krypterade login-hemligheter, secure notes och ett försiktigt första slice för payment cards.

  • Åtkomst: /password-manager (endast inloggade webbanvändare)
  • Funktioner: krypterade per-user-vaultposter, ingen extra behörighetsgate, entry types för login/secure note/payment card samt explicit vägran att lagra CVV/CVC

Se dokumentation för Password Manager →


SocialGPT Chrome-tillägg

Webbläsarbrett AI-tillägg för Toolbox-svar, faktakontroll, Facebook-adminflöden och SoundCloud-insamling.

  • Åtkomst: Chrome-tilläggets popup / webbläsarens snabbmenyer
  • Funktioner: Webbläsarbrett AI-läge, markeringsknappar, opt-in för Facebook-adminstatistik, SoundCloud Insights-insamling

Se dokumentation för SocialGPT Chrome-tillägget →


X mention-bot / ToolGPT

Publik X/Twitter-botidentitet som drivs av Tools interna mention-/reply-system.

  • Åtkomst: publik guide under /docs/sv/x-bot; adminkontrollrum under /admin/social-media-tools/x-bot
  • Funktioner: mention-polling, bevakningsord, dry-run-kandidatsvar, manuell approve-postning, trådkontextfångst, publik FAQ, prompttransparens och förklaring av ToolGPT-identiteten

Se dokumentation för X mention-botten →

Se den publika ToolGPT-ändringsloggen →


RSS Watch - Feedvisare

Webbaserad RSS-aggregator med kategorisering, feedkällhantering och inline-redigering.

  • Åtkomst: /rss (kräver permission:rss)
  • Funktioner: Feedhantering, kategorivy, AI-analitik, sökning

Se RSS Watch dokumentation →


Playwright-guide

Fokuserad steg-för-steg-guide för hur Playwright används i Tools via lagrade adminscript, browserbot.sh och projektets E2E-runner.

  • Åtkomst: Browser Automation-admin under /admin/browser-automation och Playwright E2E-admin under /admin/browser-automation/playwright
  • Funktioner: lagrade script, persistenta profiler, record/open-flöden, shell-wrapper, E2E-körningar och checklista för första setup

Se Playwright-guiden →


Microsoft To Do

Personlig Microsoft To Do-integration för inloggade användare, med tvåvägssynk och autentiserad API-åtkomst.

  • Åtkomst: /settings/integrations/microsoft-todo (kräver inloggning)
  • Funktioner: OAuth-koppling, list/uppgiftshantering, direkt synk, autentiserade /api/microsoft-todo/*-endpoints

Se dokumentation för Microsoft To Do →


Whisper-transkribering

Köbaserad transkribering av media med progress i både webbgränssnitt och API.

  • Åtkomst: /whisper (kräver permission:whisper.use)
  • Funktioner: URL-kö, stegvis progress, retries/fel, synlighet för ägare/admin, autentiserade /api/whisper/*

Se dokumentation för Whisper →


Mensövervakning

Personlig cykelövervakning för inloggade användare, nu även med valfria SMS-påminnelser och föräldravarningar.

  • Åtkomst: /menstrual-tracking (kräver inloggning)
  • Funktioner: profil med födelsedatum/första start, smartare cykelberäkning vid rapporteringsglapp, uppskattad nästa start, valfria SMS-påminnelser och föräldravarningar

Se dokumentation för mensövervakning →


Min profil

Personliga kontoinställningar och tjänstöversikt för inloggade användare.

  • Åtkomst: /users/profile (kräver inloggning)
  • Funktioner: uppdatera namn/e-post, spara mobilnummer, sätta/byta lösenord, använda inloggningssidan för forgot-password/reset, hantera Google-koppling, länka barnkonton och hoppa direkt till tillgängliga tjänsteinställningar

Se dokumentation för min profil →


Online Sessions

Liveöversikt över aktuella Tools-besökare uppdelade i inloggade användare, gäster och sannolika botar.

  • Åtkomst: publik /online, detaljerad adminvy under /admin/security/online-users
  • Funktioner: separata räknare för bot/gäst/användare, grupperad live-sessiondetalj för admins, en adminhanterad IP/CIDR-whitelist som kan dölja betrodd intern trafik från de live räknarna och konfigurerbara user-agent-regler som kan klassa interna verktyg eller automationsklienter som botar överallt där de live räknarna visas

vBulletin Onboarding

Slug-baserat publikt onboardingflöde med invite-nycklar, statussidor, delegerade nyckelskapare och scoped forumgruppsgodkännanden.

  • Åtkomst: publik onboarding under /vbulletin/onboarding, adminhantering under /admin/security/vbulletin, delegerad nyckelskapning under /vbulletin/onboarding/keys
  • Funktioner: slug-only- och slug+key-URL:er, statussidor, schemalagd matchning mot forumkonton, valfri auto-approve, per-config-delegering för invite-nycklar och valfria nyckelspecifika redirect-destinationer vid lyckad onboarding

Se dokumentation för vBulletin Onboarding →


Snöbollseffekten – hur kommer jag in?

Steg-för-steg-guide med skärmdumpar för den befintligt-konto-först-variant av onboarding som används för Snöbollseffekten.

  • Åtkomst: publik guide under /docs/sv/snobollseffekten
  • Funktioner: skärmdumpar för onboarding-sidan, forumregistreringen, invite-kodsfältet, sista onboardingsteget och statussidan

Se Snöbollseffektens guide →


Snöbollseffekten vBulletin-integration

Teknisk anteckning för den Snöbollseffekten-specifika vBulletin-integrationen i headern, route-hanteringen, loggbytet och medlemswidgetarna.

  • Åtkomst: publik guide under /docs/sv/snobollseffekten-vbulletin-integration
  • Funktioner: redirect-reglerna /snowball till /snowball/forum, header-baserat loggbyte, tidig CSS för dold originallogga, preload/preconnect-hints, laddning av Tools-bundle samt anteckningar om medlemswidgetarna latest-member.js och member-count.js

Se den tekniska guiden för Snöbollseffektens vBulletin-integration →


OAuth-endpoints (Slack + SoundCloud)

Referens for OAuth start/callback-endpoints samt guidning for Slack redirect URL.

  • Atkomst: Webroutes under /oauth/*
  • Innehaller: Slack start/callback/callback-url, SoundCloud start/callback

Se OAuth-endpoints dokumentation →


Autentisering & Tokens

API Key Autentisering

Används för server-till-server-förfrågningar till publika API:er:

Authorization: Bearer sk-YOUR_API_KEY_HERE

Där du hittar din nyckel:

  1. Logga in på Tools
  2. Navigera till Mina API-nycklar (/keys/mine)
  3. Skapa eller kopiera en befintlig nyckel

Websession Autentisering

Används för webbläsarbaserade förfrågningar till skyddade endpoints:

  • Automatisk via webbläsarkakor
  • Kräver permission:rss, permission:openai.manage, osv.

Tools AI Bearer-tokens

Speciella tokens för AI-specifika operationer:

Authorization: Bearer YOUR_TOOLS_AI_TOKEN

Användning: /api/ai/url/analyze och liknande AI-endpoints


Snabbreferens

Funktion Endpoint Autentisering Rate Limit
IRC-sökning POST /api/irclog/search API Key 60/min
RSS-analys POST /feed-admin/analytics/generate Websession 20/min
SMS-sändning POST /api/sms/send API Key 300/min
MCU-sökning GET /api/mcu/timeline Publik 300/min
DNS-fråga GET /api/dns/zones API Key 60/min
DNSBL-fråga POST /api/dnsbl/query API Key 9000/min

Felhantering

Alla API:er följer standard HTTP-statuskoder:

  • 200 OK - Förfrågan lyckades
  • 400 Bad Request - Ogiltiga parametrar eller valideringsfel
  • 401 Unauthorized - Saknad eller ogiltig autentisering
  • 403 Forbidden - Autentiserad men saknar nödvändiga behörigheter
  • 429 Too Many Requests - Hastighetsbegränsning överskriden
  • 500 Internal Server Error - Serverfel

Felsvarsformat

{
  "ok": false,
  "error": "Läsvänligt felmeddelande",
  "error_code": "VALIDATION_ERROR"
}

Tools Miljö

Tools stödjer flera domäner med en enda .env-konfiguration genom att detektera den aktuella begärandets värd.


Ändringslogg

För nya funktioner och senaste ändringar: Se Ändringslogg →


Senast uppdaterad: 2026-05-19 API Version: v1