Listings
6 routes. Paths are relative to https://api.intersink.com/v1.
- POST/listings/{type}/{id}/inquiriesAsk the seller about a listing: { message, active_profile_id? } (500 characters)
- GET/listings/{type}/{id}/interestA listing's inquiries and offers, for its seller (?status=open|accepted|declined|withdrawn|closed)
- POST/listings/{type}/{id}/offersMake an offer: { amount, currency?, message?, active_profile_id? }. No currency means the listing's own (else the channel's). One open offer per person and listing; a new amount replaces it.
- PATCH/listings/interest/{interestId}The seller accepts or declines an offer { status: accepted | declined } or closes an inquiry { status: closed }; the buyer withdraws their own { status: withdrawn }
- GET/listings/interest/mineYour own inquiries and offers on this channel (x-ref or X-App-Key)
- POST/listings/posts/{id}/soldThe author marks their listing post sold: it leaves the feeds, open inquiries and offers close and those people are told
Ask the seller about a listing: { message, active_profile_id? } (500 characters)
POST/listings/{type}/{id}/inquiries
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| typerequired | string, path | One of: "posts", "products". |
| idrequired | string, path |
Response
201. The payload in data is not described in the spec yet.
A listing's inquiries and offers, for its seller (?status=open|accepted|declined|withdrawn|closed)
GET/listings/{type}/{id}/interest
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| typerequired | string, path | One of: "posts", "products". |
| idrequired | string, path | |
| statusrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
Make an offer: { amount, currency?, message?, active_profile_id? }. No currency means the listing's own (else the channel's). One open offer per person and listing; a new amount replaces it.
POST/listings/{type}/{id}/offers
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| typerequired | string, path | One of: "posts", "products". |
| idrequired | string, path |
Response
201. The payload in data is not described in the spec yet.
The seller accepts or declines an offer { status: accepted | declined } or closes an inquiry { status: closed }; the buyer withdraws their own { status: withdrawn }
PATCH/listings/interest/{interestId}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| interestIdrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Your own inquiries and offers on this channel (x-ref or X-App-Key)
GET/listings/interest/mine
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| x-ref | string, header | |
| active_profile_idrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
The author marks their listing post sold: it leaves the feeds, open inquiries and offers close and those people are told
POST/listings/posts/{id}/sold
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
201. The payload in data is not described in the spec yet.