Allegro REST API

gdzie?

Polska | polski | PLN
Jak zacząć Jak zacząć
  • Pierwsze kroki
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
Poradniki Poradniki
  • Wystawianie oferty produktu
  • Serwisy zagraniczne Allegro
  • Zarządzanie ofertami
  • Pasuje do
  • Zarządzanie zgłoszeniami ofert do kampanii
  • Rabaty i promocje
  • Zamówienia
  • Wysyłam z Allegro
  • One Fulfillment by Allegro
  • Dyskusje i reklamacje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Afiliacja
FAQCo nowego Co nowego
  • Aktualności
  • Changelog
DokumentacjaRegulaminKontaktZarządzaj API Zarządzaj API
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  • API Status
  • User-agent
  • Pierwsze kroki
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
  • Wystawianie oferty produktu
  • Serwisy zagraniczne Allegro
  • Zarządzanie ofertami
  • Pasuje do
  • Zarządzanie zgłoszeniami ofert do kampanii
  • Rabaty i promocje
  • Zamówienia
  • Wysyłam z Allegro
  • One Fulfillment by Allegro
  • Dyskusje i reklamacje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Afiliacja
FAQ
  • Aktualności
  • Changelog
DokumentacjaRegulaminKontakt
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  • API Status
  • User-agent
  1. Allegro REST API
  2. Aktualności
  3. Oznaczanie zdjęć AI (AI Act) – dodajemy oraz rozszerzamy strukturę aiCoCreatedContent o pole images oraz wprowadzamy zmiany w POST /sale/images

13 lipca 2026

Oznaczanie zdjęć AI (AI Act) – dodajemy oraz rozszerzamy strukturę aiCoCreatedContent o pole images oraz wprowadzamy zmiany w POST /sale/images

W związku z wejściem w życie unijnego Aktu o sztucznej inteligencji (AI Act), od 2 sierpnia 2026 roku na sprzedawców zostanie nałożony obowiązek informowania kupujących o tym, czy zdjęcia w ofercie zostały wygenerowane lub istotnie zmodyfikowane przez AI (czyli spełniają ustawową definicję deepfake).

Aby umożliwić Tobie i Twoim użytkownikom realizację tego obowiązku prawnego, wprowadzamy zmiany w zasobach Katalogu Produktów, zarządzaniu ofertami oraz wgrywaniu zdjęć. Modyfikacje zostały zaprojektowane tak, aby zachować pełną kompatybilność wsteczną.

Jakie zmiany wprowadzimy?

Dodajemy strukturę aiCoCreatedContent do requestów tworzących ofertę i rozszerzymy ją o tablicę obiektów images, która docelowo będzie przechowywać listę adresów URL zdjęć zadeklarowanych jako wygenerowane przez sztuczną inteligencję.

Ważna informacja: Tablica images została już przez nas wdrożona w strukturach odpowiedzi i żądań, jednak tymczasowo nie będzie obsługiwana i będzie zwracać zawsze pustą tablicę obiektów []. Udostępniamy ją, dlatego możesz sprawdzić, jakie zmiany w strukturze payloadu wprowadzimy i już teraz dostosować swoją aplikację. O tym, kiedy pole stanie się w pełni funkcjonalne, poinformujemy w następnej komunikacji.

Modyfikacja dotyczy następujących endpointów:

  • POST /sale/product-offers
  • PATCH /sale/product-offers/{id}
  • GET /sale/product-offers/{id}
  • GET /sale/products
  • GET /sale/products/{productId}
  • POST /sale/product-proposals
  • POST /sale/images
Ważne zasady techniczne

Podczas dostosowywania swojej aplikacji zwróć szczególną uwagę na poniższą logikę działania systemu:

  • Deklaracja podczas dodawania - informację o tym, czy zdjęcie zostało wygenerowane lub istotnie zmodyfikowane przez AI, można przekazać podczas pierwszego dodawania (uploadu/przesyłania) zdjęcia do platformy. Po dodaniu pliku nie zmienisz tej deklaracji przez API.
  • Zdjęcia z zewnętrznych źródeł - jeśli przesyłasz nowe zdjęcie z zewnętrznego adresu URL i wskażesz je w sekcji aiCoCreatedContent.images, system oznaczy je w bazie jako wygenerowane przez AI.
  • Zdjęcia istniejące już w bazie - jeśli używasz zdjęcia, które znajduje się już w bazie Allegro, Twoja deklaracja w żądaniu zostanie pominięta. System bazuje na pierwotnym oznaczeniu pliku, które otrzymasz w response.
  • Domyślny brak AI - jeśli nie wskażesz danego zdjęcia w tablicy aiCoCreatedContent.images lub pominiesz parametry oznaczania przy nowo wgrywanych plikach, system domyślnie uzna, że na zdjęciu nie należy wyświetlać oznaczenia AI.
  • Na zdjęciach dodanych do Allegro, które zostały wygenerowane lub istotnie zmodyfikowane przez AI, dodamy znak wodny “AI”.
Zarządzanie ofertami

Do struktury żądania oraz odpowiedzi dodajemy sekcję aiCoCreatedContent, a w niej tablicę obiektów images. Przekażesz lub otrzymasz w niej adresy URL zdjęć stworzonych przy użyciu AI. Dotyczy to:

  • POST /sale/product-offers
  • PATCH /sale/product-offers/{id}
  • GET /sale/product-offers/{id}

Przykładowy fragment requestu:

{
 "productSet": [
   {
     "quantity": {
       "value": 1
     },
     "product": {
       "id": "c9e39cae-9cb6-11e9-a2a3-2a2ae2dbcce4",
    (...)
   }
 ],
 "id": "12394584234",
 "name": "Test offer name",
 "category": {
   "id": "257931"
 },
 (...),
 "images": [
"https://...adres-pierwszego-obrazka.jpeg",
"https://...adres-drugiego-obrazka.jpeg"
],
 "description": {
   "sections": [
     {
       "items": [
         {
           "type": "TEXT",
           "content": "<p>opis oferty</p>"
         },
         {
           "type": "IMAGE",
           "url": "https://...adres-drugiego-obrazka.jpeg"
         }
       ]
     }
   ]
 },
 "aiCoCreatedContent": {  // nowa sekcja definiująca zawartość współtworzoną przez AI 
   "images": [  // tablica zdjęć, które zostaną oznaczone jako wygenerowane lub istotnie zmodyfikowane przez AI
     {
       "url": "https://...adres-drugiego-obrazka.jpeg"  // url zdjęcia z galerii zdjęć produktu, które zostanie oznaczone jako wygenerowane lub istotnie zmodyfikowane przez AI  
     }
   ]
 }
}
Katalog Produktów

W response rozszerzamy strukturę aiCoCreatedContent o tablicę obiektów images. Brak danego zdjęcia w tej tablicy oznacza, że nie zostało ono zadeklarowane jako stworzone przez AI. Dotyczy to:

  • GET /sale/products
  • GET /sale/products/{productId}

Dla POST /sale/product-proposals w żądaniu ignorujemy oznaczenie AI (nie musisz go tu przesyłać, jednak system nie zwróci błędu, jeśli się pojawi). Dla tego endpointu przekazujesz zdjęcie wgrane za pomocą POST /sale/images i to na tamtym etapie następuje deklaracja o użyciu AI. W response dodamy strukturę aiCoCreatedContent wraz z tablicą obiektów images, aby zapewnić spójność danych.

Przykładowy fragment response’a:

{
...
 "id": "c9e39cae-9cb6-11e9-a2a3-2a2ae2dbcce4",
 "name": "iPhone 5s",
 "images": [
       {
         "url": "https://...adres-pierwszego-obrazka.jpeg"
       },
       {
         "url": "https://...adres-drugiego-obrazka.jpeg"
       }
     ]
... 
  "aiCoCreatedContent": {
   "paths": [
     "images",
     "description"
   ],
   "images": [  // nowa tablica zdjęć, które zostały oznaczone jako wygenerowane lub istotnie zmodyfikowane przez AI
     {
       "url": "https://...adres-drugiego-obrazka.jpeg"  // url zdjęcia oznaczonego jako wygenerowane lub istotnie zmodyfikowane przez AI
     }
   ]
 }
...
}
Wgrywanie zdjęć

Zmiany wdrożymy również na endpoincie służącym do bezpośredniego przesyłania zdjęć: POST /sale/images. Wprowadzimy tam dwa nowe rozwiązania:

  • Nowy query parametr: isAiCoCreated=true/false - będzie działać dla wszystkich obsługiwanych typów Content-Type (w tym również dla application/vnd.allegro.public.v1+json),
  • Nowe pole w body żądania: "isAiCoCreated": true/false - będzie dostępne wyłącznie przy zastosowaniu nagłówka Content-Type: "application/vnd.allegro.public.v1+json".
Co grozi za brak oznaczenia?

Zgodnie z przepisami AI Act, jeśli nie umożliwisz sprzedawcy dopełnienia obowiązku transparentności wobec konsumentów, grożą Ci surowe administracyjne kary pieniężne, które dla dużych przedsiębiorstw mogą wynieść do 15 mln euro lub do 3% całkowitego światowego rocznego obrotu z poprzedniego roku obrotowego.

Dlaczego wprowadzamy tę zmianę?

Nowe prawo unijne ma na celu ochronę konsumentów i budowanie zaufania do informacji w sieci. Kupujący podejmują decyzje zakupowe m.in. na podstawie zdjęć, dlatego muszą mieć jasność, czy oglądają autentyczną fotografię produktu, czy komputerową, fotorealistyczną wizualizację.

Sprzedawca odpowiada za treści publikowane w ofertach, w tym za materiały dostarczane przez agencje, grafików czy hurtownie. Zapowiadane zmiany w API pozwolą sprzedawcom i integratorom działać zgodnie z prawem i uniknąć wysokich kar.

Dostosuj swoją integrację jak najszybciej, przed 2 sierpnia 2026 roku, aby zapewnić użytkownikom nieprzerwane i bezpieczne zarządzanie ofertami.

Więcej informacji oraz odpowiedzi na najczęściej zadawane pytania znajdziesz w Pomocy dla sprzedającego.

Allegro

Serwisy Grupy Allegro

  • Allegro.cz
  • Allegro.sk
  • Allegro.hu
  • Onedelivery.cz

Dostosuj ustawienia wyświetlania

ustawienia dotyczą tylko tej przeglądarki