Documentation about the web API is missing.

A couple things I noticed trying to get started with the web API:

• There are no usage instruction for the web client in the readme, just for the rtm client
• It was unclear to me from the readme that I could use just the web client part of it to interact with our web API, so I went with another REST client library. Later I discovered this package fit my uses exactly when Don told me it definitely should (and then I found the example folder).
• It looks like you need to instantiate the web client with a token, but you may not necessarily have a token and might be trying to get one using the oauth flow (and specifically the oauth.access method). I think it might make the most sense to instantiate a client without a token, and then it adds the token to itself automatically as part of calling oauth.access. Then, so I can reuse it for different calls for different users if I wanted to it could have methods (or properties?) to swap out the token on the client object I already have.

[ekmartin]

You can actually use the web client without a token, so you could actually do something like this right now:

const client = new WebClient();
return client.oauth.access(clientId, clientSecret, code)
  .then(data => {
    const authClient = new WebClient(data.access_token);
  });

But I agree that it’s unclear.

[tylucaskelley]

Glad to hear it! And yeah, for now just reading the web api docs is good enough for what I’m doing but looking forward to seeing some real docs / examples from you guys!