Merge pull request appdotnet#29 from kosso/master

Updated Global endpoint.

Author: berg

resources/README.md

@@ -72,6 +72,11 @@ Guiding principles are:
             <td>GET</td>
             <td><a href="/appdotnet/api-spec/blob/master/resources/posts.md#retrieve-a-users-personalized-stream">Retrieve a User's personalized stream</a></td>
         </tr>
+        <tr>
+            <td>/stream/0/posts/stream/global</td>
+            <td>GET</td>
+            <td><a href="/appdotnet/api-spec/blob/master/resources/posts.md#retrieve-the-global-stream">Retrieve the Global stream</a></td>
+        </tr>        
     </tbody>
 </table>
 

resources/posts.md

@@ -531,3 +531,59 @@ Return the 20 most recent <a href="/appdotnet/api-spec/blob/master/objects.md#po
 ...
 ]
 ```
+
+
+## Retrieve the Global stream
+
+Return the 20 most recent <a href="/appdotnet/api-spec/blob/master/objects.md#post">Post</a>s from the Global stream.
+
+### URL
+> https://api.app.net/stream/0/posts/stream/global
+
+### Parameters
+
+*See [General Parameters](#general-parameters) for optional parameters you can use with this query.*
+
+### Example
+
+> GET https://api.app.net/stream/0/posts/stream/global
+```js
+[{
+    "id": "1", // note this is a string
+    "user": {
+        ...
+    },
+    "created_at": "2012-07-16T17:25:47Z",
+    "text": "@berg FIRST post on this new site #newsocialnetwork",
+    "source": {
+        "name": "Rdio for iOS",
+        "link": "http://rdio.com"
+    },
+    "reply_to": null,
+    "annotations": {
+        "wellknown:geo": {
+            "type": "Point",
+            "coordinates": [102.0, .5]
+        },
+        "rdio:song": ...
+    },
+    "entities": {
+        "mentions": [{
+            "name": "berg",
+            "id": "2",
+            "indices": [0, 4]
+        }],
+        "hashtags": [{
+            "name": "newsocialnetwork",
+            "indices": [34, 50]
+        }],
+        "links": [{
+            "text": "this new site",
+            "url": "https://join.app.net"
+            "indices": [20, 32],
+        }]
+    }
+},
+...
+]
+```