Od dziś możesz skorzystać z wersji beta.v2 zasobów:

• POST /sale/product-offers,
• PATCH /sale/product-offers/{offerId}.

W wersji beta.v2 wdrożyliśmy wzorzec asynchronicznego API ze względu na dłuższy czas wykonania niektórych operacji po stronie platformy Allegro, takich jak np. zmiany statusu publikacji oferty.

Ważne! Wersję beta.v1 wyłączymy 12 grudnia 2020 roku.

Aby skorzystać z wersji beta.v2 wystarczy, że przekażesz w nagłówkach Content-Type oraz Accept wartość “application/vnd.allegro.beta.v2+json”.

W wersji beta.v2 w odpowiedzi na prawidłowe żądanie na zasobie /sale/product-offers otrzymasz jeden z trzech statusów:

• 200 OK - zmiany wdrożymy od razu. Występuje tylko w przypadku metody PATCH,
• 201 Created - ofertę utworzymy od razu. Występuje tylko w przypadku metody POST,
• 202 Accepted - ze względu na dłuższy czas wykonania operacji zadanie przeprowadzimy asynchronicznie. Występuje w przypadku metody POST i PATCH.

Wraz ze statusem 202 Accepted zwrócimy w odpowiedzi nagłówek Location, w którym znajdziesz odnośnik do nowego zasobu w postaci: /sale/product-offers/{offerId}/operations/{operationId}. Odpytaj go metodą GET, aby sprawdzić status zadania. W odpowiedzi zwrócimy jeden z dwóch statusów:

• 202 Accepted - operacja nie została jeszcze zakończona. Powtórz poprzednie żądanie.
• 303 See Other - operacja została zakończona. W nagłówku Location przekażemy odnośnik do zasobu w postaci: /sale/product-offers/{offerId}. Skorzystaj z metody GET i przesłanego odnośnika w polu Location. W odpowiedzi zwrócimy aktualne dane oferty.

Więcej informacji o nowym sposobie działania zasobów /sale/product-offers znajdziesz w naszym poradniku:

• publikacja oferty w asynchronicznym API,
• edycja oferty w asynchronicznym API.