Wine Comments
Get all Wine Comments
warning
This endpoint gives you all wine comments, even if there is no bottle in cellar. Please use Get Bottles endpoint to get comments associated to quantity.
HTTP Request
GET /wine-comments
Example
- Request
- Response
$ curl --request GET --url 'https://app.winesitting.com/api/v2/wine-comments' \
--header 'Authorization: Bearer YourBearerToken' \
--header 'content-type: application/json'
[
{
"id": 24842,
"comment": "marefclient",
"created_at": {
"date": "2024-09-02 11:24:11.000000",
"timezone_type": 3,
"timezone": "Europe/Paris"
},
"updated_at": {
"date": "2024-09-02 11:24:11.000000",
"timezone_type": 3,
"timezone": "Europe/Paris"
},
"format": 0.75,
"wine": {
"id": 98509,
"wine": "Domaine AF Gros",
"appelation": "Richebourg",
"region": "Bourgogne",
"color": "Rouge",
"millesime": 2020,
"alcohol": 13.5,
"ranking": "Grand Cru",
"description": null
}
},
{
"id": 24811,
"comment": "Un commentaire",
"created_at": {
"date": "2024-02-29 13:51:58.000000",
"timezone_type": 3,
"timezone": "Europe/Paris"
},
"updated_at": {
"date": "2024-02-29 13:51:58.000000",
"timezone_type": 3,
"timezone": "Europe/Paris"
},
"format": 0.15,
"wine": {
"id": 103435,
"wine": "Les Bertrand",
"appelation": "Fleurie",
"region": "Beaujolais",
"color": "Rouge",
"millesime": 2021,
"alcohol": 13.5,
"ranking": null,
"description": "Coup d'Folie"
}
}
...
]
Get a specific Wine Comment
HTTP Request
GET /wine-comments/{{wineId}}/{{wineFormat}}
Query parameters
| Name | Required | Type | Details |
|---|---|---|---|
| wineId | required | int | |
| wineFormat | required | string | ex: 0.75 |
Example
- Request
- Response
$ curl --request GET --url 'https://app.winesitting.com/api/v2/wine-comments/103435/0.15' \
--header 'Authorization: Bearer YourBearerToken' \
--header 'content-type: application/json'
{
"id": 24811,
"comment": "Un commentaire",
"created_at": {
"date": "2024-02-29 13:51:58.000000",
"timezone_type": 3,
"timezone": "Europe/Paris"
},
"updated_at": {
"date": "2024-02-29 13:51:58.000000",
"timezone_type": 3,
"timezone": "Europe/Paris"
},
"format": 0.15,
"wine": {
"id": 103435,
"wine": "Les Bertrand",
"appelation": "Fleurie",
"region": "Beaujolais",
"color": "Rouge",
"millesime": 2021,
"alcohol": 13.5,
"ranking": null,
"description": "Coup d'Folie"
}
}
Create a Wine Comment
HTTP Request
POST /wine-comments
Wine Comment parameters
| Name | Required | Type | Details |
|---|---|---|---|
| format | required | float | ex: 0.75 |
| wine_id | required | int | |
| comment | required | string |
Example
- Request
- Response
$ curl --request POST --url 'https://app.winesitting.com/api/v2/wine-comments' \
--header 'Authorization: Bearer YourBearerToken' \
--header 'content-type: application/json' \
--data '
{
"comment": "My sku 2",
"format": 0.15,
"wine_id": 15777
},
'
The created comment
Edit a Wine Comment
HTTP Request
PUT /wine-comments/{{wineId}}/{{wineFormat}}
Wine Comment parameters
See Get a specific Wine Comment for parameters.
Example
- Request
- Response
$ curl --request PUT --url 'https://app.winesitting.com/api/v2/wine-comments/15777/0.15' \
--header 'Authorization: Bearer YourBearerToken' \
--header 'content-type: application/json' \
--data '
{
"comment": "My sku 3",
"format": 0.75,
"wine_id": 15777
},
'
The modified comment
Delete a Wine Comment
HTTP Request
DELETE /wine-comments/{{wineId}}/{{wineFormat}}
Parameters
See Get a specific Wine Comment for parameters.
Example
- Request
- Response
$ curl --request DELETE --url 'https://app.winesitting.com/api/v2/wine-comments/15777/0.15' \
--header 'Authorization: Bearer YourBearerToken' \
--header 'content-type: application/json' \
The deleted comment