[NEWS] Udostępniliśmy zasoby do zarządzania Centrum wiadomości / We have added resources for Message Center management

[MaciejFrackowiak]

Centrum wiadomości to miejsce komunikowania się kupujących i sprzedających. To połączenie czata i poczty elektronicznej, w którym znajdziesz korespondencję prowadzoną w ramach Allegro, jak i wiadomości od kupujących.

Udostępniliśmy dzisiaj nowe zasoby, dzięki którym obsłużysz Centrum wiadomości za pośrednictwem naszego API:

• GET /messaging/threads - pobierz listę wszystkich wątków,

• GET /messaging/threads/{threadId} - pobierz szczegółowe informacje o danym wątku,

• PUT /messaging/threads/{threadId}/read - oznacz wybrany wątek jako przeczytany,

• POST /messaging/messages - napisz nową wiadomość,

• GET /messaging/threads/{threadId}/messages - pobierz listę wiadomości dla wybranego wątku,

• POST /messaging/threads/{threadId}/messages - napisz nową wiadomość w wybranym wątku,

• GET /messaging/messages/{messageId} - pobierz szczegółowe informacje o danej wiadomości,

• DELETE /messaging/messages/{messageId} - usuń wybraną wiadomość,

• POST /messaging/message-attachments - dodaj deklarację załącznika,

• PUT /messaging/message-attachments/{attachmentId} - dodaj załącznik,

• GET /messaging/message-attachments/{attachmentId} - pobierz załącznik.

Więcej informacji o Centrum wiadomości znajdziesz w naszym poradniku.

---

The Message Center is the place where the buyers and the sellers communicate each other. It is a combination of chat and e-mail, in which you will find correspondence conducted within Allegro, as well as messages from buyers.

Today, we released new resources to help you operate the Message Center via our API:

• GET /messaging/threads - retrieve the list of user threads,

• GET /messaging/threads/{threadId} - retrieve a thread with provided identifier,

• PUT /messaging/threads/{threadId}/read - mark a particular thread as read,

• POST /messaging/messages - write a new message to recipient,

• GET /messaging/threads/{threadId}/messages - retrieve a list of messages in thread with provided identifier,

• POST /messaging/threads/{threadId}/messages - write a new message in existing thread,

• GET /messaging/messages/{messageId} - retrieve a message with provided identifier,

• DELETE /messaging/messages/{messageId} - delete message with provided identifier,

• POST /messaging/message-attachments - add attachment declaration before uploading,

• PUT /messaging/message-attachments/{attachmentId} - upload attachment using identifier that was declared,

• GET /messaging/message-attachments/{attachmentId} - download attachment with provided identifier.

You can find more information about the Message Center in our guide.

[shambo666]

do dokumentacji wkradł się błąd

zapytanie zwraca id a nie login

[MaciejFrackowiak]

@shambo666 Dziękuję za zwrócenie uwagi, dokonamy niezbędnej poprawki.

[daniel8702]

@MartaNowaczyk Bardzo dziękujemy za implementację API wiadomości, bardzo długo my i nasi klienci na to czekali.
Nie marnując czasu zaczęliśmy implementację :).
Mamy dużych klientów którzy mają bardzo dużo wiadomości.

Natomiast wydaje mi się, że można by było to trochę bardziej zoptymalizować aby ilość zapytań do API nie była aż taka duża, co znacząco zmniejszy obciążenie waszego serwera.

Według mojej oceny dodanie zakresu dat tak jak trafnie zostało to dodane do listy wiadomości dla głównego wątku.
Czyli dodanie to głównych wątków (thread) parametrów:

• before - by wskazać wątki które mają ostatnią wiadomość przed datą,
• after - by wskazać wątki które mają ostatnią wiadomość po dacie.

Może warto by było również zwiększyć ilość (limit) pobierania wiadomości.?

Chyba, że pracujecie nad jakimiś innymi rozwiązaniami, bo te obecne nie są zbyt optymalne, lub może czegoś nie wiemy (brak w dokumentacji)?

Pozdrawiam serdecznie.

[MaciejFrackowiak]

@daniel8702 Dokumentacja na chwilę obecną zawiera wszystkie niezbędne i obowiązujące informacje. Swoje sugestie co do dalszego rozwoju Centrum wiadomości proszę zamieść w Discussions.

[tomasz-grzesik]

@MaciejFrackowiak, proszę informujcie o takich zmianach zmiana nazwy pola w API z "id" na "login".
Ta cicha zmiana niestety może być przyczyną błędnego działania oprogramowania.

[MaciejFrackowiak]

@tomasz-grzesik Ta zmiana jest zgodna z dokumentacją - wcześniej zwracane pole było niezgodne jak zauważył @shambo666.

[tomasz-grzesik]

Jeśli developerzy mają sugerować się dokumentacją, a nie aktualnie zwracanymi polami, to macie sporo do zaktualizowania w dokumentacji.

[MaciejFrackowiak]

@tomasz-grzesik Staramy się poprawiać wszelkie braki i niedoskonałości jak tylko możemy.

[tomasz-grzesik]

Nie ma sprawy. W sumie to pole id kompletnie tam nie pasowało :)

[whyun1]

Hi,
I tried to use "GET /messaging/threads", but I got an error "{"errors":[{"code":"AccessDenied","message":"Access is denied","details":null,"path":null,"userMessage":"Access denied. Contact the author of the application."}]}".
How to solve this problem.
Thanks in advance.

[MaciejFrackowiak]

@whyun1 I checked resources a minute ago and everything worked fine. Please, give me a trace-id of your request, I will check it in our logs.

[whyun1]

@whyun1 I checked resources a minute ago and everything worked fine. Please, give me a trace-id of your request, I will check it in our logs.

Hi.
The trace-id is 18fc6f46b2801538.

[MaciejFrackowiak]

@whyun1 You missed a required scope "allegro:api:messaging" to manage the Message Center. We informed about required change in our news.

[whyun1]

@whyun1 You missed a required scope "allegro:api:messaging" to manage the Message Center. We informed about required change in our news.

solved.
Thanks