IRC API
A simplified RESTful API for interacting with persistent Internet Relay Chat connections.
Networks ¶
A “network” represents a user-defined connection to IRC. Each network has one or more IRC servers to which the API will connect.
Networks collection ¶
List existing networksGET/networks
Example URI
GET /networks
Response
200
Headers
Content-Type: application/json
Network information ¶
Get network informationGET/networks/{network}
Example URI
GET /networks/quakenet
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
Response
200
Headers
Content-Type: application/json
Response
404
If the specified network doesn’t exist
Update network informationPOST/networks/{network}
Example URI
POST /networks/quakenet
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
Response
204
Response
400
Response
404
Delete networkDELETE/networks/{network}
Example URI
DELETE /networks/quakenet
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
Response
204
Response
404
Chats ¶
A chat represents either an IRC channel or a private message with another IRC user.
Chats collection ¶
List existing chatsGET/networks/{network}/chats
Example URI
GET /networks/quakenet/chats
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
Response
200
Headers
Content-Type: application/json
Response
404
Create new chatPOST/networks/{network}/chats
Example URI
POST /networks/quakenet/chats
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
Response
200
Headers
Content-Type: application/json
Response
400
Response
404
Chat information ¶
Get chat informationGET/networks/{network}/chats/{chat}
Example URI
GET /networks/quakenet/chats/dmdirc
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
- chat
string
(required) Example: dmdircThe name of the chat.
Response
200
Headers
Content-Type: application/json
Response
404
Delete chatDELETE/networks/{network}/chats/{chat}
Example URI
DELETE /networks/quakenet/chats/dmdirc
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
- chat
string
(required) Example: dmdircThe name of the chat.
Response
204
Response
404
Chat messages ¶
Get chat messagesGET/networks/{network}/chats/{chat}/messages
Example URI
GET /networks/quakenet/chats/dmdirc/messages
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
- chat
string
(required) Example: dmdircThe name of the chat.
Response
200
Headers
Content-Type: application/json
Response
404
Send chat messagePOST/networks/{network}/chats/{chat}/messages
Example URI
POST /networks/quakenet/chats/dmdirc/messages
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
- chat
string
(required) Example: dmdircThe name of the chat.
Response
200
Headers
Content-Type: application/json
Response
400
Response
404
Chat users ¶
List chat usersGET/networks/{network}/chats/{chat}/users
Example URI
GET /networks/quakenet/chats/dmdirc/users
URI Parameters
- network
string
(required) Example: quakenetThe name of the network.
- chat
string
(required) Example: dmdircThe name of the chat.
Response
200
Headers
Content-Type: application/json
Response
404