Przejdź do głównej zawartości
Wersja: 7.x

Jak przez API dodać do pola plik graficzny

Poznaj praktyczne kroki dodawania grafiki do rekordów w YetiForce przez API – artykuł wyjaśnia wymagane parametry i pokazuje konkretny przykład implementacji.

Przed przejściem dalej należy zapoznać się z dostępnymi metodami i sposobem komunikacji z API opisanymi w dokumentacji API.

Aplikacja YetiForce posiada dwa rodzaje pól obsługujących pliki graficzne:

  • Plik graficzny
  • Plik graficzny (wiele)

graphic file

Dodawanie pliku graficznego​

W celu dodania pliku graficznego do rekordu należy skorzystać ze standardowego punktu końcowego do tworzenia lub edycji rekordu poprzez metodę POST (tworzenie) lub PUT (edycja).

/webservice/WebserviceStandard/{moduleName}/Record

Pole z plikiem dodaje się analogicznie jak inne pola rekordu, z tą różnicą, że jego wartością nie jest łańcuch tekstowy lub liczba, lecz tablica z obiektem. Obiekt pliku graficznego tworzonego z poziomu API wymaga trzech elementów:

  • name - nazwa pliku.

  • key - losowy ciąg znaków, niepowtarzalny w obrębie plików graficznych danego pola.

  • baseContent - plik graficzny przekonwertowany na format base64. Nie należy umieszczać fragmentu początkowego z typem MIME (np. data:image/jpeg;base64,).

Poniżej przedstawiono przykład dodania pliku graficznego do kontaktu za pomocą narzędzia Postman, gdzie imagename to nazwa pola określona w ustawieniach modułu.

graphic file postman