17 stycznia 2018
Udostępniamy zasoby do zarządzania kontaktami
Niedawno udostępniliśmy ogłoszenia w Allegro, dlatego teraz udostępniamy wam zasoby, które pozwolą zarządzać kontaktami w REST API:
- POST /sale/offer-contacts - chcę utworzyć kontakt.
- PUT /sale/offer-contacts/{id} - chcę zmienić dane kontaktu.
- GET /sale/offer-contacts/{id} - chcę pobrać szczegóły danego kontaktu.
- GET /sale/offer-contacts - chcę pobrać szczegóły wielu kontaktów.
Kontakt możesz przypisać, gdy wystawiasz lub edytujesz ogłoszenie przez WebAPI Allegro. Zapoznaj się z naszym poradnikiem, opisaliśmy w nim jak możesz to zrobić.
Na stronie oferty - w miejscu, w którym w pozostałych kategoriach wyświetla się opcja "Kup Teraz" - wyświetlimy przycisk, który pozwoli odsłonić kontakt. Wyświetlimy maksymalnie 2 telefony i 1 e-mail.
Ograniczenia (dla pojedynczego konta Allegro)
- Nie możesz mieć więcej niż 15 kontaktów
- Możesz podać maksymalnie 1 e-mail
- Możesz podać maksymalnie 2 telefony
POST /sale/offer-contacts
Przykładowy request:
>
curl -X POST \'
'https://api.allegro.pl/sale/offer-contacts'
-H 'content-type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json’ \
-H 'authorization: Bearer {token}' \
-d '{
"name": "contact name", -- nazwa kontaktu; wymagane, maksymalna liczba znaków - 250
"emails": [{
"address": "mail@allegro.pl/" -- adresy e-mail; możesz podać 1; niewymagane
}], "phones": [ -- nr telefonów; możesz podać maksymalnie 2; niewymagane
{
"number": "+48 111 111 111"
},
{
"number": "+48 222 222 222"
}
]
}'
Przykładowy response:
{
{"id":"067e6162-3b6f-4ae2-a171-2470b63dff00",
"name":"contact name",
"emails":
[{"address"::"mail@allegro.pl/"}],
"phones":[{
"number": "+48 111 111 111"
},
{
"number": “+48 222 222 222"
}
]
}'
PUT /sale/offer-contacts/{id}
W URL podaj UUID danego kontaktu.
Przykładowy request:
>
curl -X PUT
'https://api.allegro.pl//sale/offer-contacts/12f43efd-2369-480d-9f945178eeb9c663'
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json’ \
-H 'authorization: Bearer {token}’ \
-d '{ "name": "new name", -- nazwa kontaktu; wymagane, maksymalna liczba znaków - 250
"emails": [{ -- adresy e-mail; możesz podać 1; niewymagane
"address": "new@allegro.pl/" }],
"phones": [ -- nr telefonów; możesz podać maksymalnie 2; niewymagane
{
"number": "+48 111 111 222"
},
{
"number": "+48 222 222 222"
}
] }'
Przykładowy response:
{
{"id":"12f43efd-2369-480d-9f94-5178eeb9c663",
"name":"new name",
"emails":[{"address":"new@allegro.pl
"phones": [
{
"number": "+48 111 111 222"
},
{
"number": "+48 222 222 222"
}
] }
GET /sale/offer-contacts/{id}
W URL podaj UUID danego kontaktu.
Przykładowy request:
>
curl -X GET \
https://api.allegro.pl/sale/offer-contacts/067e6162-3b6f-4ae2-a171-2470b63dff00'
-H 'Accept: application/vnd.allegro.public.v1+json’ \
-H 'authorization: Bearer {token}’ \
Przykładowy response:
{
{"id":"067e6162-3b6f-4ae2-a171-2470b63dff00",
"name":"contact name",
"emails":
[{"address":"mail@allegro.pl/"}],
"phones":[{
"number":"+48 111 111 111”}]}
GET /sale/offer-contacts
Przykładowy request:
>
curl -X GET \
'https://api.allegro.pl/sale/offer-contacts/?seller.id={sellerId}'
-H 'Accept: application/vnd.allegro.public.v1+json’ \
-H 'authorization: Bearer {token}’ \
Przykładowy response:
{
[
{"id":"067e6162-3b6f-4ae2-a171-2470b63dff00",
"name":"contact name 1",
"emails":
[{"address"::"mail1@allegro.pl/"}],
"phones":[{
"number":"+48 111 111 111"}]},
{"id":"167e6162-3b6f-4ae2-a171-2470b63dff00",
"name":"contact name 2",
"emails":
[{"address"::"mail2@allegro.pl/"}],
"phones":[{
"number":"+48 222 222 222”}]}
]
