Что такое callbackUrl?

Question

[1233211]

Есть api, которое принимает какие-то данные и callbackUrl, я так понимаю, что туда надо какую-то ссылку передать, но какую и что оно с этой ссылкой обычно делает? Понятно, когда передаёшь функцию, оно вызывает функцию, а со ссылкой что происходит? Api же по идее не может пользователю открыть вкладку или в текущей вкладке пользователя перекинуть по этому url?

Comments

[gsaw]

callbackUrl это ссылка на ваше приложение. К примеру, что бы аутентифицироваться, вы перенаправляете вызов на https://auth.api/?callbackUrl=https://mycool.app/ и передаете ему ссылку, куда должен быть сделан редирект после аутентификации. Это может быть главная страница, а может быть страница, где вы поздравляете с успешной аутентификацией.

Answer 1

[Pavel Shvedov]

Есть вариант, что апишка в результате редиректнет на этот урл

Answer 2

[Stalker_RED]

На примере сервиса оплаты.

У тебя есть интернет магазин, в котором продаются плющевые медведи.
Пользователь добавил пару медведей в корзину, и магазин показывает ему кнопку "оплатить" от платежной системы.
Для этого сервер делает запрос у внешнему API типа "у нас тут намечается сделка на 149.99, сгенерируйте нам кнопочку "оплатить через mastercard"".
Кнопочка отображается в браузере у клиента. Он на нее нажимает, и переходит на страничку платежной системы (или в попап). До этого все обходилось без коллбеков - ты запросил код кнопки, они его отдали тебе, пользователь увидел кнопочку, нажал и... он же ушел с твоего сайта, и ты не знаешь что он там на сайт платежной системы делает.
А после факта оплаты твоему сайту неплохо бы получить подтверждение, о том, что пользователь действительно оплатил. Или у него денег не хватило, или интернет отрубился, или заснул в процессе покупки, whatever...
Вот для таких случаев ты и указываешь callbackUrl. Адрес на твоем сайте, куда платежная система (или какой-то другой внешний API) можеет прислать своё уведомление. Что оплата прошла успешно, или что все пропало, отменяем.

Answer 3

[Павел]

читать документацию по конкретно этому api, не?

Answer 4

[alekssamos]

Для программы: когда не ты вызываешь чужой API, запрашивая всё время данные,
а он сам вызывает твой скрипт.
Это тоже самое, что webhook.

Для пользователя: когда он ушёл с сайта, адрес, куда он сможет вернуться после какого-то действия.

Примеры:

http://rucaptcha.example.com/in.php?image=qwe.png&callback=https://mysite.example.com/success.php

Код придёт через 20 секунд, сервис rucaptcha.example.com сам его тебе отправит на твой сайт mysite.example.com.

А для пользователя, как уже говорили выше, передаёшь две ссылки, на успех и на ошибку. Если всё окей, допустим оплата прошла, открывается одно, а не прошла или отменена - другое.