git.iko.soy/urbit.org
on 5e6a67f help sign in
urbit.org/docs/programming/reference/arvo/eyre.md
58 lines 2.3 kB history raw
1---
2sort: 5
3---
5`%eyre`
6=======
8Our http server.
10Unix sends http messages to `%eyre`, and `%eyre` produces http messages
11in response. In general, apps and vanes do not call `%eyre`; rather,
12`%eyre` calls apps and vanes. `%eyre` uses `%ford` and `%gall` to
13functionally publish pages and facilitate communication with apps.
15`%eyre` primarily parses web requests and handles them in a variety of
16ways, depending on the control string. Nearly all of these are
17essentially stateless, like functional publishing with `%ford`.
18Additionally, there's a fairly significant component that handles
19`%gall` messaging and subscriptions, which must be stateful.
21HTTP Methods
22============
24`GET` `gog` `https://[ship-name].urbit.org/gog/[service]` Owner
25requesting a page on her own Urbit. `gig`
26`https://[ship-name].urbit.org/gig/[user-name]/[service]` Another user
27requesting a page on a foreign Urbit.
29`goe`
30`https://[ship-name].urbit.org/goe/[service]/[port]/[stream]/[sequence]`
31`https://[ship-name].urbit.org/goe/[service]/[port]/[stream]/[sequence].json`
32Pulls a specific response to her subscription on her own Urbit. `gie`
33`https://[ship-name].urbit.org/gie/[user-name]/[service]/[port]/[stream]/[sequence]`
34`https://[ship-name].urbit.org/gie/[user-name]/[service]/[port]/[stream]/[sequence].json`
35Pulls a specific response to her subscription on a foreign Urbit.
37`PUT` `tos`
38`https://[ship-name].urbit.org/tos/[service]/[port]/[stream]/[path]`
39`{oryx: [string]}` Initiate a subscription on her own Urbit. `tis`
40`https://[ship-name].urbit.org/tis/[user-name]/[service]/[port]/[stream]/[path]`
41`{oryx: [string]}` Initiate a subscription on a foreign Urbit.
43`tom` `https://[ship-name].urbit.org/tom/[service]/[port]/[sequence]`
44`{oryx: [string], xyro: [json]}` Send a message to her Urbit with
45sequence number `[sequence]`. `tim`
46`https://[ship-name].urbit.org/tim/[user-name]/[service]/[port]/[sequence]`
47`{oryx: [string], xyro: [json]}` Send a message to a foreign Urbit with
48sequence number `[sequence]`.
50`tou` `https://[ship-name].urbit.org/tou/[service]/[port]/[stream]`
51Unsubscribe from stream `[stream]` on her Urbit. `tiu`
52`https://[ship-name].urbit.org/tiu/[user-name]/[service]/[port]/[stream]`
53Unsubscribe from stream `[stream]` on a foreign Urbit.
55urb.js
56======
58<list></list>