PlatitunPlatitun · API · The deal · Reply to a review
Reply to a review
POST /api/v1/reviews/{id}/replyKey scope: orders · changes data, the Idempotency-Key header is required
A public reply — ONCE. Obscenity and personal attacks do not pass in a reply either: the rule is the same for both sides.
Request fields
| Field | Type | What it is |
|---|---|---|
text required | string | The reply text. |
Response fields
| Field | Type | What it is |
|---|---|---|
order | string | The order the review belongs to. |
Refusal reasons
A rule refusal arrives as {"error":"rejected","refusal":{"kind":"…"}} with status 409. Refusals common to all endpoints are in the rules section.
| Code | What happened and what to do |
|---|---|
not_found | The record does not exist or is not yours. The ownership condition is in the database query itself, so someone else’s record looks like a missing one. |
too_short | The text is too short. A one-word answer helps neither the buyer nor the review. |
contacts | Contact details were found in the text — an email, a phone number, a messenger link. Taking the deal off the marketplace strips the buyer of protection and the seller of the guarantee. Remove them and send again. |
language | The text contains obscenity or a personal attack. The rule is the same for both sides. |
reply_already | A reply already exists. A review is answered once. |
Nearby in this section
GET /api/v1/orders— My ordersGET /api/v1/orders/{id}— One orderPOST /api/v1/orders/{id}/confirm— Take the orderPOST /api/v1/orders/{id}/decline— Decline the orderPOST /api/v1/orders/{id}/deliver— Mark the deliveryPOST /api/v1/orders/{id}/messages— Message the buyerGET /api/v1/orders/{id}/handover— The order vaultsPOST /api/v1/orders/{id}/handover— Put credentials into a vaultPOST /api/v1/orders/{id}/handover/reveal— Read the buyer’s vaultPOST /api/v1/orders/{id}/dispute/reply— Answer a disputeGET /api/v1/reviews— Reviews about meGET /api/v1/complaints— My complaintsPOST /api/v1/complaints— Complain about a buyerGET /api/v1/work-mode— Work mode and presencePUT /api/v1/work-mode— Set the work mode