Stories
10 routes. Paths are relative to https://api.intersink.com/v1. This group belongs to a feature in beta.
- GET/storiesGet feed
- POST/storiesCreate story
- DELETE/stories/{id}Delete story
- GET/stories/{id}/commentsGet comments
- POST/stories/{id}/commentsAdd comment
- POST/stories/{id}/likeToggle like
- POST/stories/{id}/shareToggle share
- POST/stories/{id}/viewRecord view
- DELETE/stories/comment/{commentId}Delete comment
- GET/stories/myGet my stories
Get feed
GET/stories
Public: no sign-in needed.
Parameters
| Name | Type | Description |
|---|---|---|
| page | number, query | |
| limit | number, query | |
| active_profile_id | string, query | |
| latitude | string, query | |
| longitude | string, query |
Response
200. The payload in data is not described in the spec yet.
Create story
POST/stories
Needs a signed-in user (Bearer token or access_token cookie).
Request body application/json
| Field | Type | Description |
|---|---|---|
| title | string | At most 255 characters. |
| description | string | |
| url | string | At most 255 characters. |
| status | string | One of: "published", "draft", "archived", "expired". |
| file_id | number | |
| active_profile_id | string | |
| location | string | "lat,lng" where it was posted (stored rounded to ~110 m). At most 64 characters. |
| place | string | At most 120 characters. |
Response
201. The payload in data is not described in the spec yet.
Delete story
DELETE/stories/{id}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Get comments
GET/stories/{id}/comments
Public: no sign-in needed.
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| pagerequired | string, query | |
| limitrequired | string, query | |
| active_profile_idrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
Add comment
POST/stories/{id}/comments
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Request body application/json
| Field | Type | Description |
|---|---|---|
| contentrequired | string | At most 255 characters. |
| active_profile_id | string |
Response
201. The payload in data is not described in the spec yet.
Toggle like
POST/stories/{id}/like
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| active_profile_idrequired | string, query |
Response
201. The payload in data is not described in the spec yet.
Record view
POST/stories/{id}/view
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| active_profile_idrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
Delete comment
DELETE/stories/comment/{commentId}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| commentIdrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Get my stories
GET/stories/my
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| page | number, query | |
| limit | number, query | |
| active_profile_id | string, query | |
| latitude | string, query | |
| longitude | string, query |
Response
200. The payload in data is not described in the spec yet.