@@ -7,6 +7,8 @@
8# API Connectors
8# API Connectors
10+> Note: This lesson depends on some code that needs to be updated before the examples will work correctly. This will be addressed in the near future. We apologize!
10Most people have lots of data stored in online services, many of
12Most people have lots of data stored in online services, many of
11which have APIs. API connectors allow the user to access this
13which have APIs. API connectors allow the user to access this
12data from within their Urbit.
14data from within their Urbit.
@@ -86,13 +88,7 @@ for a particular piece of data, while `%y` is a request for a
86directory listing. Roughly, `%x` means Unix `cat` and `%y` means
88directory listing. Roughly, `%x` means Unix `cat` and `%y` means
89−> Sometimes you wish to expose a tree where a part of the path
91+> Sometimes you wish to expose a tree where a part of the path can't be enumerated. For example, a `%y` of `/issues/by-repo` "should" produce a list of all Github users, but we don't do that because it's too long. Instead, we just produce our own username (from the `web.plan` file). You can still access repos from other users, you just don't see them in the directory listing.
90−> can't be enumerated. For example, a `%y` of `/issues/by-repo`
91−> "should" produce a list of all Github users, but we don't do
92−> that because it's too long. Instead, we just produce our own
93−> username (from the `web.plan` file). You can still access
94−> repos from other users, you just don't see them in the
97The usual flow for implementing this tree of data makes heavy use
93The usual flow for implementing this tree of data makes heavy use
98of the `connector` library. This library is well documented in
94of the `connector` library. This library is well documented in