Przejdź do treści
Dialova

Dokumentacja IRC · Średnio zaawansowany

Odpowiedzi numeryczne IRC

Odpowiedź numeryczna jest wiadomością, której poleceniem jest trzycyfrowy kod. Kod i parametry określają strukturę; końcowy tekst objaśniający jest przeznaczony do wyświetlenia i może zależeć od serwera lub języka.

Zespół Dialovy · Sprawdzono

Odczytuj strukturę zamiast analizować zdanie #

Odpowiedzi NAMES skierowane do klienta Alice
:irc.example 353 Alice = #atelier :@Alice Bob
:irc.example 366 Alice #atelier :End of /NAMES list

353 jest tutaj poleceniem numerycznym. Alice to odbiorca odpowiedzi, a #atelier i lista nicków są parametrami przydatnymi klientowi. Zdanie kończące listę nie jest stałym identyfikatorem do rozpoznawania słowo w słowo.

Najczęstsze punkty odniesienia #

KodZastosowanieNa co zwrócić uwagę
001Powitanie po rejestracji połączeniaNie utożsamiaj go z samym otwarciem TCP.
005ISUPPORTOpisuje właściwości serwera; nie jest CAP ACK.
311 / 318Początek informacji WHOIS i koniecPomiędzy nimi mogą pojawiać się inne odpowiedzi.
332 / 333Temat i powiązane metadane333 jest rozpowszechnioną praktyką, ale sam nie stanowi całej odpowiedzi TOPIC.
353 / 366Lista NAMES i koniecLista może być podzielona na części.
401Nie znaleziono celuNie daje prawa do omijania zasad sieci.
482Brak uprawnień na kanaleSprawdź rzeczywistą rolę, a nie samo menu klienta.
903 / 904Powodzenie / niepowodzenie SASLNie wszystkie kody 9xx oznaczają więc powodzenie.

Odpowiedzi historyczne i rozszerzenia #

RFC opisują historyczną podstawę, nie wszystkie obecne odpowiedzi. IRCd i rozszerzenia dodają kody; klient powinien móc poprawnie je wyświetlić lub pominąć bez wymyślania znaczenia. WHOIS może ujawniać dodatkowe informacje zależnie od sieci i uprawnień.

Rodziny 4xx i 5xx obejmują wiele błędów, ale ta wskazówka nie zastępuje dokumentacji mechanizmu. Nowoczesne rozszerzenia używają też ustrukturyzowanych odpowiedzi takich jak FAIL, WARN i NOTE.

Powiąż odpowiedź z właściwym działaniem #

Klient może odbierać zdarzenia i wiele odpowiedzi jednocześnie. Nie zakładaj, że następna wiadomość jest odpowiedzią na ostatnie polecenie. Uwzględniaj parametry celu i znaczniki końca; labeled-response, jeśli jest dostępne, zapewnia bardziej zaawansowane wiązanie odpowiedzi z żądaniami.

Źródła i weryfikacja

Przykłady używają fikcyjnych nicków i domen, z wyjątkiem wyraźnie udokumentowanych punktów połączenia. Rozszerzenia i ustawienia właściwe danej sieci są zaznaczone w tekście.