freechat/docs/content/overview/protocol.md
2021-02-23 21:44:26 -08:00

1.4 KiB

title anchor weight
Protocol protocol 6

What this section covers

What one should expect when attempting to implement a server/client compliant with the Freechat protocol.

What this section does not cover

Details on implementation are found under:

Details what endpoints are available to send/receive data through.

Details what kind of data is sent back and forth between clients and servers.

Overview Content

The Freechat protocol is based on HTTP and currently outlines a json-based API hereafter referred to as just, the "JSON API". Due to the standards already in place with HTTP and JSON it is safe to assume that this protocol be more of an outline for what HTTP endpoints to have and what kind of data is to be expected in exchanges.

Most servers will likely run on one of three ports, 80 for basic HTTP, 443 for secure HTTP traffic, or 4536 for most others. If using a special port then servers should expect user applications to specify the port.

For connections over SSH or other protocols it really is up to server owners to let new users know about this important detail. SSH based servers are not discouraged, in fact they are highly encouraged to exist and operate :^)