[NEWS] Dodaj własny parametr przez REST API / Add your own parameter via REST API

Od dziś, gdy [wystawiasz](https://developer.allegro.pl/documentation/#operation/createOfferUsingPOST) lub [edytujesz](https://developer.allegro.pl/documentation/#operation/updateOfferUsingPUT) ofertę, dodasz swój własny parametr. Dzięki temu opisy ofert będą bardziej precyzyjne, a kupujący łatwiej podejmie decyzję o zakupie. Propozycje własnych parametrów zbierzemy i zweryfikujemy, a w przyszłości przeniesiemy je do standardowych parametrów.

**Pamiętaj, że własne parametry:**

- przekażesz tylko w wybranych kategoriach. W odpowiedzi dla [GET /sale/categories](https://developer.allegro.pl/documentation/#operation/getCategoriesUsingGET) i [GET /sale categories/{id}](https://developer.allegro.pl/documentation/#operation/getCategoryUsingGET_1) dodaliśmy nowe pole - customParametersEnabled, w którym sprawdzisz, czy umożliwiliśmy to w danej kategorii,
- dodasz w nowym polu customParameters w modelu oferty. Parametr będzie widoczny na stronie oferty,
- mają podobne ograniczenie, jak na formularzu wystawiania na stronie internetowej - maksymalnie dodasz 4 własne parametry, dla których przekażesz po jednej wartości,
- nie mogą być duplikatami - jeżeli parametr o takiej nazwie istnieje już w Allegro, to zwrócimy odpowiedni błąd. Możesz jednak dodać własne parametry o takiej samej nazwie dla różnych ofert.

**Przykładowa struktura żądania:**

```
{
...
“parameters”: [...],
"customParameters": [
{
"name": "Nazwa twojego własnego parametru",
"values": [
"Wartość własnego parametru"
]
}
],
“description”: {...},
…
}

```
**Przykładowa struktura odpowiedzi:**

```
{
...
"parameters": [...],
"customParameters": [
{
"name": "Nazwa twojego własnego parametru",
"values": [
"Wartość własnego parametru"
]
}
],
“description”: {...},
…
}
```

-----

Today we have introduced custom parameters - you can add them when you [list ](https://developer.allegro.pl/documentation/#operation/createOfferUsingPOST)or [edit ](https://developer.allegro.pl/documentation/#operation/updateOfferUsingPUT)an offer. Owing to it descriptions of the offers will be more precise and it will make the purchase decision easier for the buyer We will collect suggestions of custom parameters and after the verification, we will add them to the standard list of parameters.

**Remember, custom parameters:**

- can be provided only in selected categories. In response to [GET /sale/categories](https://developer.allegro.pl/documentation/#operation/getCategoriesUsingGET) and [GET /sale categories/{id}](https://developer.allegro.pl/documentation/#operation/getCategoryUsingGET_1) we have added new field - customParametersEnabled in which you can check whether we have enabled custom parameters in a given category,
- you will add in customParameters field in the offer model. The parameter will be visible on the offer page.
- have the same limit as in the sales form on the website - you can add up to 4 custom parameters for which you can provide one value,
- can’t be duplicates - if parameters with this name already exist in Allegro, we will return an appropriate error. However, you can add custom parameters with the same name to the different offers.

**Sample request structure:**

```
{
...
“parameters”: [...],
"customParameters": [
{
"name": "Name of your own parameter",
"values": [
"Value of your own parameter"
]
}
],
“description”: {...},
…
}

```

**Sample response structure:**

```
{
...
“parameters”: [...],
"customParameters": [
{
"name": "Name of your own parameter",
"values": [
"Value of your own parameter"
]
}
],
“description”: {...},
…
}

```