回答:
コールバックURLは、完了後に呼び出しているAPIメソッドによって呼び出されます。だからあなたが呼ぶなら
POST /api.example.com/foo?callbackURL=http://my.server.com/bar
次に、/foo
が完了すると、リクエストをに送信しhttp://my.server.com/bar
ます。そのリクエストの内容とメソッドはさまざまです-アクセスしているAPIのドキュメントを確認してください。
それを手紙と考えてください。時々、フォームに記入するように要求して、フォームを収容していた元の封筒に入っている、事前にアドレス指定された封筒でフォームを返すという手紙を受け取ります。
フォームへの記入が完了したら、提供された返信用封筒に入れて送り返します。
callbackUrlは、戻りエンベロープに似ています。基本的に私はあなたにこのデータを送ると言っています。あなたがそれを終えたら、私はあなたの応答を待っているこのcallbackUrlにいます。したがって、APIは送信したデータを処理し、コールバックを調べて応答を送信します。
時々、一部のデータを処理するのに時間がかかる場合があり、呼び出し元が応答を待つようにしても意味がないため、これは便利です。たとえば、APIでユーザーがドキュメントを送信し、ウイルススキャンすることを許可するとします。その後、レポートを送信します。スキャンには3分程度かかる場合があります。ユーザーは3分間待つことはできません。したがって、ドキュメントを取得したことを確認し、スキャンを実行している間、発信者が他のビジネスを続行できるようにします。スキャンが終了したら、callbackUrlを使用してスキャンの結果を伝えます。
別のユースケースはOAuthのようなものである可能性があります。APIから直接呼び出されるのではなく、IDプロバイダーとの認証が完了した後、ブラウザーによってコールバックURLが呼び出されます。
通常、ユーザー名パスワードのエンドユーザーキーの後に、IDサービスプロバイダーは一時的な認証コードを使用して、ブラウザーの「コールバック」URLへのリダイレクトをトリガーします。
https://example.com/callback?code=AUTHORIZATION_CODE
次に、アプリケーションはこの認証コードを使用して、ライフタイムがはるかに長いIDプロバイダーにアクセストークンを要求できます。