Przepływy pracy interfejsu API

Pobieranie listy pakietów aukcji

Wywołaj LIST API. Obsługa filtrowania według parametru external_deal_id

Tworzenie nowego pakietu aukcji

  1. Wartość external_deal_id musi być unikalna. Wywołaj LIST z parametrem external_deal_id, aby sprawdzić, czy identyfikator został już użyty.
  2. Wywołaj Create API. Zostanie przypisana unikalna nazwa, której można użyć do pobrania utworzonego pakietu.
  3. Wywołaj Get API, aby wyświetlić szczegóły utworzonego pakietu aukcji.
  4. Opcjonalnie prześlij logo utworzonego pakietu.

Aktualizowanie pakietu aukcji

  1. Jeśli nie przechowujesz utworzonej nazwy pakietu aukcyjnego, wywołaj interfejs LIST API, filtrując według parametru external_deal_id, aby uzyskać pakiet aukcyjny, który chcesz zaktualizować.
  2. Zaktualizuj pola na podstawie wyników interfejsu LIST API.
  3. Wywołaj interfejs Patch API, aby zaktualizować pakiet aukcji. Wymagany jest parametr „updateMask”, który wskazuje pola, do których ma zostać zastosowana aktualizacja. W „updateMask” można ustawić tylko pola, które można zaktualizować.

Proces testów beta

Jedyna różnica między wersją beta a wersją ogólnodostępną polega na tym, że w wersji beta utworzone pakiety aukcji muszą mieć stan „DISCOVERY_OBJECT_STATUS_PAUSED” i nie można go aktualizować. Pakiety w stanie WSTRZYMANO nie są widoczne w interfejsie DV3. Dzięki temu giełdy mogą testować integrację interfejsu API bez wyświetlania pakietów testowych.

Zwykle wszystkie „prawdziwe” pakiety są tworzone w wersji beta jako WSTRZYMANE, a następnie AKTYWOWANE po udostępnieniu ogólnym.

Limit

2000 aktywnych pakietów na giełdę.

2000 wstrzymanych pakietów na giełdę.