IRC Log API Reference (aktuell)

Base URL: https://tools.tornevall.net/irc/api
Rate limit: normalt 60 requests/minut

Autentisering

Read-endpoints nedan ar publika.
Du kan skicka bearer-token om klienten redan anvander den:

Authorization: Bearer YOUR_API_TOKEN

Endpoints

`GET /irc/api/networks`

Hamta natverk.

Query

Parameter	Typ	Kravs	Beskrivning
`source`	string	Nej	`production` (default) eller `sandbox`

Svar (exempel)

{
  "success": true,
  "networks": [
    { "id": 1, "name": "ircnet" }
  ]
}

`GET /irc/api/networks/{networkId}/channels`

Hamta kanaler for ett natverk.

Path

Parameter	Typ	Kravs
`networkId`	integer	Ja

Query

Parameter	Typ	Kravs	Beskrivning
`source`	string	Nej	`production` (default) eller `sandbox`

Svar (exempel)

{
  "success": true,
  "channels": [
    {
      "id": 1,
      "name": "#sweden",
      "first_date": "1999-01-01 00:00:00",
      "last_date": "2026-01-01 00:00:00",
      "event_count": 123456
    }
  ],
  "source": "production"
}

`GET /irc/api/logs`

Hamta loggrader med filter, fritext och pagination.

Query

Parameter	Typ	Kravs	Beskrivning
`network_id`	integer	Nej	Filtrera per natverk
`channel_id`	integer	Nej	Filtrera per kanal
`q`	string	Nej	Fritext i meddelande/nick/kanal (och target/to_nick dar tillgangligt). Stod for `+inkludera` / `-exkludera`, inklusive citerade fraser som `+\"gammal flood\"`
`include_terms`	string	Nej	Tydliga inkluderingsord (mellanslag/komma-separerat). Alla termer maste matcha
`exclude_terms`	string	Nej	Tydliga exkluderingsord (mellanslag/komma-separerat). Termerna filtreras bort
`nick`	string	Nej	Person/nick-filter (aliassparning)
`recipient`	string	Nej	Exakt nick/target/to_nick
`private_only`	boolean	Nej	Begransa till PM
`date`	date	Nej	Exakt dag (`YYYY-MM-DD`)
`date_from`	date	Nej	Datumintervall fran
`date_to`	date	Nej	Datumintervall till
`datetime_from`	datetime	Nej	Tidsintervall fran (`YYYY-MM-DD HH:MM:SS`)
`datetime_to`	datetime	Nej	Tidsintervall till (`YYYY-MM-DD HH:MM:SS`)
`limit`	integer	Nej	1-1000, default 100
`offset`	integer	Nej	>=0, default 0
`source`	string	Nej	`production` (default) eller `sandbox`
`include_netsplit`	boolean	Nej	Visa server/net split- och merge-rader (`false` default)
`bulk_netsplit`	boolean	Nej	Vid `include_netsplit=1`, bulka sammanhang till en rad (`true` default)
`aggregate`	string	Nej	`dates` returnerar unika datum + spann i stallet for vanliga rader

Datumprioritet

date
datetime_from / datetime_to
date_from / date_to

Svar (exempel)

{
  "success": true,
  "source": "production",
  "total": 42,
  "limit": 50,
  "offset": 0,
  "results": [
    {
      "id": 123,
      "event_type": "PRIVMSG",
      "occurred_at": "1999-04-14 15:12:00",
      "nick": "TT_",
      "message_text": "Hej",
      "channel_id": 1,
      "channel_name": "#sweden"
    }
  ],
  "nick_profile": null
}

Felformat

{
  "success": false,
  "error": "Felmeddelande"
}

Vanliga statuskoder: 200, 422, 429, 500.

Exempel

curl "https://tools.tornevall.net/irc/api/networks?source=production"

curl "https://tools.tornevall.net/irc/api/networks/1/channels?source=production"

curl "https://tools.tornevall.net/irc/api/logs?network_id=1&channel_id=1&source=production&q=nu+d%C3%A5&limit=4&offset=0"

curl "https://tools.tornevall.net/irc/api/logs?network_id=1&channel_id=1&source=production&q=%2Bflood+%2B1999+-%22received+server%22&limit=100&offset=0"

curl "https://tools.tornevall.net/irc/api/logs?network_id=1&channel_id=1&source=production&datetime_from=1999-04-14+13:55:00&datetime_to=1999-04-14+16:08:00"

Legacy

/api/irclog/* ar legacy och ska inte anvandas for nya integrationer.

Last Updated: 2026-07-21
Version: 2.0

Tornevall Networks