Potraktuj to jak list. Czasami otrzymujesz list, powiedzmy z prośbą o wypełnienie formularza, a następnie odeślij go w zaadresowanej kopercie, która znajduje się w oryginalnej kopercie, w której znajdował się formularz.
Po wypełnieniu formularza, umieść go w dostarczonej kopercie zwrotnej i odeślij.
CallbackUrl jest jak ta koperta zwrotna. Zasadniczo mówisz, że przesyłam Ci te dane. Gdy skończysz, jestem na tym callbackUrl, czekając na twoją odpowiedź. Zatem interfejs API przetworzy przesłane przez Ciebie dane, a następnie zajrzy do wywołania zwrotnego, aby wysłać odpowiedź.
Jest to przydatne, ponieważ czasami przetwarzanie niektórych danych może zająć dużo czasu i nie ma sensu, aby dzwoniący czekał na odpowiedź. Załóżmy na przykład, że twój interfejs API umożliwia użytkownikom wysyłanie do niego dokumentów i skanowanie ich pod kątem wirusów. Następnie wysyłasz raport po. Skanowanie może zająć może 3 minuty. Użytkownik nie może czekać 3 minuty. Potwierdzasz więc, że dostałeś dokument i pozwalasz dzwoniącemu zająć się innymi sprawami, podczas gdy ty skanujesz, a po zakończeniu użyj callbackUrl, aby przekazać im wynik skanowania.