01 lutego 2017
Nowe zasoby - "Publikuj Ofertę również na Allegro.de"
Przygotowaliśmy dwa endpointy do hurtowego udostępniania ofert w Allegro.de:
1/ dodający odpowiednią informację do ofert (za pomocą metody PUT)
2/ pozwalający na sprawdzenie czy pierwsza czynność została wykonana prawidłowo (za pomocą metody GET)
Oba endpointy są już widoczne w naszej dokumentacji.
Jak skorzystać z udostępnionych zasobów:
1/ Wykonaj żądanie metodą PUT:
- podaj identyfikatory ofert
- oznacz je indywidualnym identyfikatorem commandId
Przykład wywołania i odpowiedzi dla metody PUT:
Request:
PUT /offers/change-additional-platforms-commands/82d14f47-ac1c-43e7-9bf7-93bcea88fc59
Content-Type: application/vnd.allegro.public.v1+json
Accept: application/vnd.allegro.public.v1+json
Accept-Language: pl-PL
{
"input": {
"offers": [
{
"id": "658468381164"
},
{
"id": "658468381165"
}
],
"platforms": [
"ALLEGRO_DE"
]
}
}
Response:
200 OK
Content-Type: application/vnd.allegro.public.v1+json
{
"id": "82d14f47-ac1c-43e7-9bf7-93bcea88fc59",
"input": {
"offers": [
{
"id": "658468381164"
},
{
"id": "658468381165"
}
],
"platforms": [
"ALLEGRO_DE"
]
},
"output": {
"status": "RUNNING",
"errors": null
}
}
2/ Możesz sprawdzić status zleconego zadania metodą GET:
Przykłady wywołania i odpowiedzi dla metody GET:
Request:
GET /offers/change-additional-platforms-commands/82d14f47-ac1c-43e7-9bf7-93bcea88fc59
Accept: application/vnd.allegro.public.v1+json
Accept-Language: pl-PL
Response, w przypadku gdy czynność się udała dla wszystkich ofert:
200 OK
Content-Type: application/vnd.allegro.public.v1+json
{
"id": "82d14f47-ac1c-43e7-9bf7-93bcea88fc59",
"input": {
"offers": [
{
"id": "658468381164"
},
{
"id": "658468381165"
}
],
"platforms": [
"ALLEGRO_DE"
]
},
"output": {
"status": "SUCCESSFUL",
"errors": null
}
}
Response, w przypadku gdy czynność się nie udała dla części ofert:
200 OK
Content-Type: application/vnd.allegro.public.v1+json
{
"id": "82d14f47-ac1c-43e7-9bf7-93bcea88fc59",
"input": {
"offers": [
{
"id": "658468381164"
},
{
"id": "658468381165"
}
],
"platforms": [
"ALLEGRO_DE"
]
},
"output": {
"status": "PARTIAL_SUCCESS",
"errors": [
{
"code": "OfferNotFoundException",
"message": "Received offers numbers that don't exist",
"details": null,
"path": "offers.658468381165",
"userMessage": "Otrzymano numery ofert, które nie istnieją"
}
]
}
}
Response, w przypadku gdy czynność się nie udała dla wszystkich ofert:
200 OK
Content-Type: application/vnd.allegro.public.v1+json
{
"id": "82d14f47-ac1c-43e7-9bf7-93bcea88fc59",
"input": {
"offers": [
{
"id": "658468381164"
},
{
"id": "658468381165"
}
],
"platforms": [
"ALLEGRO_DE"
]
},
"output": {
"status": "ERROR",
"errors": [
{
"code": "OfferNotFoundException",
"message": "Received offers numbers that don't exist",
"details": null,
"path": "offers.658468381164",
"userMessage": "Otrzymano numery ofert, które nie istnieją"
},
{
"code": "OfferNotFoundException",
"message": "Received offers numbers that don't exist",
"details": null,
"path": "offers.658468381165",
"userMessage": "Otrzymano numery ofert, które nie istnieją"
}
]
}
}
