YouTrack および Hub ヘルプの開発者ポータル

REST APIURL と OAuth2.0 エンドポイント

Hub の REST API URL

Hub の REST API は、次の URL から入手できます。

<Hub Service URL>/api/rest/

<Hub Service URL> は、ネットワーク環境での Hub サービスのベース URL です。例: 会社のサーバー www.mycompany.com と Hub サービスがあります。Hub は、www.mycompany.com/hub または hub.mycompany.com からアクセスできるように構成できます。

/api/rest/ は、Hub サービスの REST API のコンテキストパスです。

上記のサンプルベース URL の場合、REST API URL はそれぞれ次のとおりです。

  • www.mycompany.com/hub の場合:

    https://www.mycompany.com/hub/api/rest

  • hub.mycompany.com の場合:

    https://hub.mycompany.com/api/rest/

例を締めくくると、たとえば、現在のユーザーのプロファイルを取得するためのエンドポイント URL は次のとおりです。

  • www.mycompany.com/hub の場合:

    https://www.mycompany.com/hub/api/rest/users/me

  • hub.mycompany.com の場合:

    https://hub.mycompany.com/api/rest/users/me

Hub の OAuth2.0 エンドポイント

Hub サービスの場合、認証とトークンの OAuth2.0 エンドポイントは次のとおりです。

  • 認証エンドポイント URL:

    <Hub REST API URL>/oauth2/auth

  • トークンエンドポイント URL:

    <Hub REST API URL>/oauth2/token

<Hub REST API URL> は、Hub サービスの RESTAPI の URL です。詳細については、上記の説明を参照してください。前のセクションで説明したサンプル RESTAPI URL の場合、OAuth2.0 エンドポイントはそれぞれ次のとおりです。

  • www.mycompany.com/hub の場合:

    https://www.mycompany.com/hub/api/rest/oauth2/auth https://www.mycompany.com/hub/api/rest/oauth2/token

  • hub.mycompany.com の場合:

    https://hub.mycompany.com/api/rest/oauth2/auth https://hub.mycompany.com/api/rest/oauth2/token

ユーザー情報と詳細データを取得する必要がある場合は、OpenIDConnect エンドポイント(英語)の説明を確認してください。