Submit feedback on a user

POST

/users/{user_id}/feedback

users

Allows the current user to submit feedback on a user. The current user can only leave feedback on a user if the feedback allowed property on that user is set to true (see User definition for more details). And the system will only store the most recent feedback submission that the current user has submitted on a user. If the current user submits feedback multiple times, the newest feedback will overwrite the older feedback. This allows users to update their feedback as long as the feedback allowed property allows it.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://trashnothing.com/api/v1.2/users//feedback' \
--form 'positive=""'

Response Example

200 - Example 1

{
    "feedback": {
        "content": "Fred gave me a great antique table for my new apartment!",
        "date": "2020-03-01T12:01:22",
        "positive": true,
        "reviewer_user_id": 9191,
        "user_id": 2946512
    },
    "user": {
        "about_me": "Just an old fisherman looking to reuse more.",
        "country": "GB",
        "feedback": {
            "percent_positive": 87.5,
            "restriction": "no-recent-messages",
            "score": 7
        },
        "firstname": null,
        "lastname": null,
        "member_since": "2017-01-27T06:35:55",
        "profile_image": "https://lh3.googleusercontent.com/-1qVLzuOCyYg/AAAAAAAAAAI/AAAAAAAAAAA/0aGNzRAO61c/s64-c/100783935580725962164.jpg",
        "reply_time": 4850,
        "user_id": 2946512,
        "username": "fred gibson"
    }
}

Request

Path Params

user_id

string

required

A user ID.

Body Params multipart/form-data

category

string

optional

For positive feedback, category should not be set.

For negative feedback, category should be set to one of: NO_SHOW, UNRESPONSIVE, LATE, ITEM_NOT_AS_DESCRIBED, BROKEN_PROMISE, RUDE, RESELLER, SELLING, UNWANTED_MESSAGES, OTHER

Below are descriptions for each of these categories:

NO_SHOW - The user did not show up when they said they would.
UNRESPONSIVE - The user failed to respond when a response was expected.
LATE - The user showed up later than they said they would.
ITEM_NOT_AS_DESCRIBED - The user gave away an item that had a misleading on incomplete description.
BROKEN_PROMISE - The user broke a promise.
RUDE - The user was rude or impolite.
RESELLER - The user is obtaining free items to sell on other sites without disclosing their intent to resell.
SELLING - The user is selling items on trash nothing.
UNWANTED_MESSAGES - The user is sending off-topic or unrelated messages.
OTHER - This category is for anything that does not fit in any of the above categories.

content

string

optional

A comment written by the current user about the user they are leaving feedback on. This is optional for positive feedback but is required for negative feedback.

positive

string

required

If set to 1, the feedback is positive. If set to 0, the feedback is negative.

Responses

🟢200The updated user and feedback.

application/json

Body

feedback

object (Feedback)

optional

Example:

{"content":"Fred gave me a great antique table for my new apartment!","date":"2020-03-01T12:01:22","positive":true,"reviewer_user_id":9191,"user_id":2946512}

content

string

optional

A comment written by the reviewer about the user (may be null).

date

string <date-time>

optional

Date when the feedback was submitted.

positive

boolean

optional

Set to true for positive feedback and false for negative feedback.

reviewer_user_id

string

optional

The user ID of the user that submitted the feedback.

user_id

string

optional

The user ID of the user that the feedback is about.

user

object (User)

optional

Example:

{"about_me":"Just an old fisherman looking to reuse more.","country":"GB","feedback":{"percent_positive":87.5,"restriction":"no-recent-messages","score":7},"firstname":null,"lastname":null,"member_since":"2017-01-27T06:35:55","profile_image":"https://lh3.googleusercontent.com/-1qVLzuOCyYg/AAAAAAAAAAI/AAAAAAAAAAA/0aGNzRAO61c/s64-c/100783935580725962164.jpg","reply_time":4850,"user_id":2946512,"username":"fred gibson"}

about_me

string

optional

A short bio a user has written about themselves to help other members get to know them better. May be null if the user has not written anything about themselves.

country

string

optional

A 2 letter country code for the country that has been automatically detected for the user (see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ). May be null if no country has been set.

feedback

object

optional

firstname

string

optional

The first name of the user (may be null).

lastname

string

optional

The last name of the user (may be null).

member_since

string

optional

The date and time when the user first became publicly active on a group (the date may be older than when the user signed up).

profile_image

string

optional

A URL to a profile image for the user. Profile images sizes vary based on the source (Google, Facebook, Gravatar, etc) and some can be as small as 64px by 64px. Will be null for api key requests and requests where the oauth user doesn't belong to any of the same groups as this user.

reply_time

integer

optional

An estimate of how many seconds it takes this user to reply to messages. May be null when there is not enough data to calculate an estimate.

user_id

string

optional

username

string

optional

A username that can be displayed for the user (the username is NOT guaranteed to be unique). Will be null for api key requests and requests where the oauth user doesn't belong to any of the same groups as this user.

🟠400Missing or invalid parameters.

🟠404User not found.

Modified at 2022-09-11 18:59:48

Retrieve user display info

List posts by a user