Перейти к содержимому
Dialova

Документация IRC · Средний

Как читать числовые ответы IRC

Числовой ответ — сообщение, в котором команда представляет собой трёхзначный код. Код и параметры задают структуру, а заключительный поясняющий текст предназначен для отображения и может меняться в зависимости от сервера и языка.

Команда Dialova · Проверено

Разбирать структуру, а не фразу #

Ответы NAMES для клиента Alice
:irc.example 353 Alice = #atelier :@Alice Bob
:irc.example 366 Alice #atelier :End of /NAMES list

Здесь 353 — числовая команда. Alice — получатель ответа, а #atelier и список ников — полезные клиенту параметры. Фраза завершения списка не является стабильным идентификатором для буквального сравнения.

Распространённые примеры #

КодНазначениеНа что обратить внимание
001Приветствие после регистрации подключенияНе путать с простым открытием TCP.
005ISUPPORTОписывает свойства сервера; это не CAP ACK.
311 / 318Сведения WHOIS и завершение спискаМежду ними могут поступать другие ответы.
332 / 333Тема и связанные метаданные333 широко применяется, но не составляет весь ответ TOPIC.
353 / 366Список NAMES и его завершениеСписок может состоять из нескольких сообщений.
401Получатель не найденНе даёт права обходить политику сети.
482Недостаточно прав в комнатеПроверяйте реальный статус, а не только меню клиента.
903 / 904Успех или ошибка SASLНе все коды 9xx означают успех.

Исторические ответы и расширения #

RFC описывают историческую основу, а не все современные ответы. IRCd и расширения добавляют коды. Клиент должен корректно показывать или игнорировать их, не выдумывая интерпретацию. Например, WHOIS может содержать дополнительные сведения в зависимости от сети и прав.

Семейства 4xx и 5xx включают много ошибок, но это практическое правило не заменяет документацию механизма. Современные расширения также используют структурированные ответы FAIL, WARN и NOTE.

Связать ответ с нужным действием #

Клиент может одновременно получать события и несколько ответов. Не считайте следующее сообщение ответом на последнюю команду. Учитывайте параметры получателя и маркеры завершения. Labeled-response, если доступен, помогает с более сложным сопоставлением запросов и ответов.

Источники и проверка

В примерах используются вымышленные ники и домены, кроме явно указанных реальных точек подключения. Расширения и настройки отдельных сетей отмечены в тексте.