Do tej pory zewnętrzne API potrafiło zlecić generowanie, ale nie potrafiło przyjąć zdjęcia. Produkty trzeba było wgrywać w aplikacji, co oznaczało, że wszystko zbudowane na API — integracja, asystent, własny skrypt — mogło pracować wyłącznie na produktach dodanych wcześniej ręcznie.
Zmieniają się dwie rzeczy, po przeciwnych końcach tego samego procesu.
Zdjęcie produktu można teraz wgrać na konto przez API. Służą do tego dwa wywołania. Pierwsze prosi o adres do wgrania pliku, drugie rejestruje produkt, gdy plik jest już na miejscu. Plik trafia prosto do magazynu, a nie przez nasze API — dzięki temu duże zdjęcia idą szybko i bez przerwanych transferów.
Platforma sprawdza plik, zamiast wierzyć temu, co dostaje w żądaniu. Rozmiar, prawdziwy format obrazu i wymiary ustalane są z samego wgranego pliku. Plik, który nie jest obrazem, jest za duży albo zbyt mały, żeby dało się z niego generować, zostaje odrzucony od razu, z powodem, na który da się zareagować — zamiast psuć się po cichu na dalszym etapie. Przerwany transfer jest odróżniany od pliku niewłaściwego rodzaju, bo pierwszy trzeba wysłać jeszcze raz, a drugi przekonwertować.
Zarejestrowanie tego samego zdjęcia dwa razy nie tworzy drugiego produktu. Jeśli wywołanie przekroczy czas oczekiwania, można je bezpiecznie powtórzyć.
Zarejestrowany produkt nie jest od razu gotowy do generowania. Najpierw powstaje jego opis — dokładnie tak samo jak przy zdjęciu wgranym w aplikacji — i to z tego opisu korzystają generatory. Lista produktów pokazuje postęp, więc integracja wie, kiedy zacząć.
Po drugiej stronie procesu zdjęcia sesji można teraz oceniać przez API. Da się poprosić o pojedyncze wygenerowane zdjęcie i dostać sam obraz, razem ze świeżym linkiem do otwarcia w pełnym rozmiarze, a następnie zapisać przy nim akceptację albo odrzucenie. Ocena trafia dokładnie tam, gdzie ocena klikniętą w aplikacji: zdjęcie zaakceptowane przez API jest zaakceptowane w Twojej galerii, a zaakceptowane w galerii jest widoczne dla API. Jedna decyzja na zdjęcie, a nie dwie, które mogą się różnić.
Obie nowości działają na zwykłym kluczu API zespołu i nie wymagają żadnych uprawnień ponad te, których klucz już używa do zlecania generowania.