API.txt

# Tweeting

Retrieve, post, and search tweets.

GET /tweets
Get all tweets, ever! Returns: 

```js
{
  "tweets": [
    {
      "status": "Everything happens so much",
      "datetime": "2013-09-03T00:00:00",
      "username": "horse_ebooks" 
    }
    ...
  ]
}
```

POST /:username/tweets
Post a new tweet as a user. Your status should be <= 140 characters! Submit a payload:

```
{
  "status": "...text..."
}
```

GET /:username/tweets
Get all the tweets for a user. Returns:

```js
{
  "tweets": [
    {
      "status": "Everything happens so much",
      "datetime": "2013-09-03T00:00:00",
      "username": "horse_ebooks" 
    }
    ...
  ]
}
```

GET /tweets?q=:pattern
Search for all tweets that include `:pattern`. See /tweets.

GET /:username/tweets?q=:pattern
Search for all tweets from a user that include `:pattern`. See /`:username`/tweets.

# Follows

Connect people, see who follows whom, etc.

GET /:username/followers
See who follows this user. Returns:

```js
{
  "followers": [
    "horse_ebooks",
    "reyner",
    "renyer"
  ]
}
```

GET /:username/following
See who this user is following. Returns:

```js
{
  "following": [
    "horse_ebooks",
    "reyner",
    "renyer"
  ]
}
```

POST /:username/follow
Make someone follow another person. Submit a payload:

```js
{
  "username": "horse_ebooks"
}
```

# Users

List all users.

GET /users
See what users exist. Returns:

```js
{
  "usernames": [
    "horse_ebooks",
    "timmy"
  ]
}
```