People network
19 routes. Paths are relative to https://api.intersink.com/v1.
- GET/network/blocksPeople you blocked on this channel
- POST/network/blocksBlock someone: { profile_id }. Drops your connection, requests, follows and shares.
- DELETE/network/blocks/{profileId}Unblock someone
- GET/network/connectionsYour connections, newest first, with online where they allow it (?page=, ?limit= ≤ 100)
- DELETE/network/connections/{profileId}Remove a connection (they are not told)
- GET/network/onlineProfile ids of your connections online on this channel now
- GET/network/people/{profileId}One person of this channel and how you relate (connection, can_request, can_share)
- GET/network/requestsConnection requests: ?direction=incoming (default) | outgoing
- POST/network/requestsAsk to connect: { profile_id }. Accepts theirs if they already asked you.
- DELETE/network/requests/{id}Cancel a request you sent
- POST/network/requests/{id}/acceptAccept a request sent to you
- POST/network/requests/{id}/declineDecline a request sent to you (the sender isn't told)
- GET/network/searchFind people of this channel by handle or name prefix (?q=, 2–32 chars; ?limit= ≤ 25)
- GET/network/settingsYour people-network privacy: findable, show_online, requests_from, shares_from
- PATCH/network/settingsChange your privacy: { findable?: everyone|connections|nobody, show_online?: connections|nobody, requests_from?: everyone|nobody, shares_from?: connections|nobody }
- GET/network/sharesLinks shared with you (?box=received, default) or by you (?box=sent); ?unread=1, ?page=
- POST/network/sharesShare a link with connections: { url (https, ≤ 2048), title? (≤ 200), note? (≤ 280), profile_id | profile_ids (≤ 10) }
- DELETE/network/shares/{id}Remove a share from your inbox, or unsend one you sent
- POST/network/shares/{id}/readMark a share you received as read
People you blocked on this channel
GET/network/blocks
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Block someone: { profile_id }. Drops your connection, requests, follows and shares.
POST/network/blocks
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Unblock someone
DELETE/network/blocks/{profileId}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| profileIdrequired | string, path | |
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Your connections, newest first, with online where they allow it (?page=, ?limit= ≤ 100)
GET/network/connections
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Remove a connection (they are not told)
DELETE/network/connections/{profileId}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| profileIdrequired | string, path | |
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Profile ids of your connections online on this channel now
GET/network/online
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
One person of this channel and how you relate (connection, can_request, can_share)
GET/network/people/{profileId}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| profileIdrequired | string, path | |
| x-ref | string, header |
Response
200. The payload in data is of type object.
Connection requests: ?direction=incoming (default) | outgoing
GET/network/requests
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Ask to connect: { profile_id }. Accepts theirs if they already asked you.
POST/network/requests
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header |
Response
201. The payload in data is not described in the spec yet.
Cancel a request you sent
DELETE/network/requests/{id}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Accept a request sent to you
POST/network/requests/{id}/accept
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Decline a request sent to you (the sender isn't told)
POST/network/requests/{id}/decline
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Find people of this channel by handle or name prefix (?q=, 2–32 chars; ?limit= ≤ 25)
GET/network/search
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.
Your people-network privacy: findable, show_online, requests_from, shares_from
GET/network/settings
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header |
Response
200. The payload in data is of type object.
Change your privacy: { findable?: everyone|connections|nobody, show_online?: connections|nobody, requests_from?: everyone|nobody, shares_from?: connections|nobody }
PATCH/network/settings
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header |
Response
200. The payload in data is of type object.
Mark a share you received as read
POST/network/shares/{id}/read
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| x-ref | string, header |
Response
200. The payload in data is not described in the spec yet.