如何获取 BlueJeans REST API 的 user_id 或 enterprise_id？

Posted 2023-04-13

【中文标题】如何获取 BlueJeans REST API 的 user_id 或 enterprise_id？

【英文标题】：How to obtain a user_id or enterprise_id for the BlueJeans REST API?

【发布时间】：2018-12-15 12:03:17

【问题描述】：

我正在尝试在 Python 中使用 BlueJeans REST API，该 API 记录在其 Github 页面 (https://github.com/bluejeans/api-rest-meetings/tree/master/libs/python) 及其通用 API 文档页面 (https://bluejeans.github.io/api-rest-meetings/site/index.html) 上。

到目前为止，我已经编写了一个方法来使用我存储在我的 Django 设置中的客户端凭据获取令牌：

import json
from urllib.parse import urljoin
import requests
import logging
import BlueJeansMeetingsRestApi
from django.conf import settings
from rest_framework import status

logger = logging.getLogger(__name__)


class ConferenceScheduler(object):
    BASE_URL = 'https://api.bluejeans.com'

    @staticmethod
    def get_token():
        # Obtain an access token to initiate a session with BlueJeans
        # (We use the Client Grant Type which grants us enterprise-level access)
        response = requests.post(
            url=urljoin(base=ConferenceScheduler.BASE_URL, url='/oauth2/token'),
            json=
                'grant_type': 'client_credentials',
                'client_id': settings.BLUEJEANS_KEY,
                'client_secret': settings.BLUEJEANS_SECRET)
        if response.status_code == status.HTTP_200_OK:
            return json.loads(response.content).get('access_token')
        else:
            logger.error(f"A request for a BlueJeans access token returned a non-200 response.\n"
                         f"Status code: response.status_code\n"
                         f"Reason: response.reason")

我在 Django shell 中使用它如下：

In [2]: from lucy_web.lib.conferencing import *

In [3]: BlueJeansMeetingsRestApi.configuration.api_key['access_token'] = ConferenceSch
   ...: eduler.get_token()

In [4]: api_instance = BlueJeansMeetingsRestApi.ApplicationApi()

In [5]: user_id = settings.BLUEJEANS_USER_ID

In [7]: application = BlueJeansMeetingsRestApi.Application()

在这里，我从“BlueJeans Meeting I.D.”获得了user_id BlueJeans 企业管理控制台中的字段。但是，如果我尝试创建一个客户端应用程序，我会收到一个来自 401（未经授权）HTTP 响应的 ApiException：

In [8]: api_response = api_instance.create_client_application(user_id, application)
---------------------------------------------------------------------------
ApiException                              Traceback (most recent call last)
<ipython-input-8-1bf90ba9e2a8> in <module>()
----> 1 api_response = api_instance.create_client_application(user_id, application)

~/.local/share/virtualenvs/lucy-web-CVxkrCFK/lib/python3.6/site-packages/BlueJeansMeetingsRestApi/apis/application_api.py in create_client_application(self, user_id, application, **kwargs)
     65             return self.create_client_application_with_http_info(user_id, application, **kwargs)
     66         else:
---> 67             (data) = self.create_client_application_with_http_info(user_id, application, **kwargs)
     68             return data
     69 

~/.local/share/virtualenvs/lucy-web-CVxkrCFK/lib/python3.6/site-packages/BlueJeansMeetingsRestApi/apis/application_api.py in create_client_application_with_http_info(self, user_id, application, **kwargs)
    148                                         _preload_content=params.get('_preload_content', True),
    149                                         _request_timeout=params.get('_request_timeout'),
--> 150                                         collection_formats=collection_formats)
    151 
    152     def regenerate_client_application_secret(self, user_id, client_id, **kwargs):

~/.local/share/virtualenvs/lucy-web-CVxkrCFK/lib/python3.6/site-packages/BlueJeansMeetingsRestApi/api_client.py in call_api(self, resource_path, method, path_params, query_params, header_params, body, post_params, files, response_type, auth_settings, callback, _return_http_data_only, collection_formats, _preload_content, _request_timeout)
    324                                    body, post_params, files,
    325                                    response_type, auth_settings, callback,
--> 326                                    _return_http_data_only, collection_formats, _preload_content, _request_timeout)
    327         else:
    328             thread = threading.Thread(target=self.__call_api,

~/.local/share/virtualenvs/lucy-web-CVxkrCFK/lib/python3.6/site-packages/BlueJeansMeetingsRestApi/api_client.py in __call_api(self, resource_path, method, path_params, query_params, header_params, body, post_params, files, response_type, auth_settings, callback, _return_http_data_only, collection_formats, _preload_content, _request_timeout)
    151                                      post_params=post_params, body=body,
    152                                      _preload_content=_preload_content,
--> 153                                      _request_timeout=_request_timeout)
    154 
    155         self.last_response = response_data

~/.local/share/virtualenvs/lucy-web-CVxkrCFK/lib/python3.6/site-packages/BlueJeansMeetingsRestApi/api_client.py in request(self, method, url, query_params, headers, post_params, body, _preload_content, _request_timeout)
    369                                          _preload_content=_preload_content,
    370                                          _request_timeout=_request_timeout,
--> 371                                          body=body)
    372         elif method == "PUT":
    373             return self.rest_client.PUT(url,

~/.local/share/virtualenvs/lucy-web-CVxkrCFK/lib/python3.6/site-packages/BlueJeansMeetingsRestApi/rest.py in POST(self, url, headers, query_params, post_params, body, _preload_content, _request_timeout)
    261                             _preload_content=_preload_content,
    262                             _request_timeout=_request_timeout,
--> 263                             body=body)
    264 
    265     def PUT(self, url, headers=None, query_params=None, post_params=None, body=None, _preload_content=True,

~/.local/share/virtualenvs/lucy-web-CVxkrCFK/lib/python3.6/site-packages/BlueJeansMeetingsRestApi/rest.py in request(self, method, url, query_params, headers, body, post_params, _preload_content, _request_timeout)
    217 
    218         if not 200 <= r.status <= 299:
--> 219             raise ApiException(http_resp=r)
    220 
    221         return r

ApiException: (401)
Reason: Unauthorized
HTTP response headers: HTTPHeaderDict('Server': 'BlueJeans Proxy', 'Date': 'Fri, 06 Jul 2018 21:15:54 GMT', 'Cache-Control': 'must-revalidate, no-cache, no-store', 'X-Trace-Token': 'sj1-prod-cobalt-01-158865374', 'Content-Type': 'text/html; charset=ISO-8859-1', 'Content-Length': '280')
HTTP response body: <html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=ISO-8859-1"/>
<title>Error 401 </title>
</head>
<body>
<h2>HTTP ERROR: 401</h2>
<p>Problem accessing /v1/user/307901319/developer_applications. Reason:
<pre>    Unauthorized</pre></p>
<hr />
</body>
</html>

如何获取用户 ID 或企业 ID？从文档来看，似乎所有端点都需要这个，但不清楚如何首先获得它。

【参考方案1】：

事实证明，无法从 BlueJeans 管理控制台获取此信息；他们的客户支持通过电子邮件将其发送给我。

【参考方案2】：

这是我在 Powershell 中的代码，我相信将其重写为 Python 或任何其他语言并不难：

function GetAccessToken()

    Write-Log-Message "Retrieving access token"

    $config = readConfiguration

    $postParams = @grant_type='password';username=$config.username;password=$config.password
    $response = Invoke-WebRequest -Uri https://api.bluejeans.com/oauth2/token?Password -Method POST -Body $postParams | ConvertFrom-Json    

    $global:access_token = $response.access_token
    $global:user_id = $response.scope.user

    Write-Log-Message "User $global:user_id"
    Write-Log-Message "Access token $global:access_token"

【参考方案3】：

您确实可以仅从客户端凭据 OAuth 调用中获取企业和用户 ID

1) 拨打 POST /oauth2/token?Client 电话。您将收到访问令牌和额外字段

    
      "access_token": "af9d00...3",
      "expires_in": 3600,
      "scope": 
        "enterprise": 28663,
        "partitionName": "z12",
        "partition": 
          "id": 22,
          "name": "z12"
        ,
    "capabilities": []
      
    

从此 API 响应中您知道企业号：28663

现在，您可以通过字符串匹配或电子邮件 ID 来查找用户：

2) 拨打电话 GET v1/enterprise/28663/users?fields=username,firstName,middleName,lastName,isEnterpriseAdmin,enterpriseJoinDate,email&textSearch=julianne&access_token=6c........03，您将收到此数据

  "count": 1,
  "users": [
    
      "firstName": "Julianne",
      "lastName": "Doe",
      "enterpriseJoinDate": 1519967214000,
      "middleName": "",
      "id": 18314208,
      "isEnterpriseAdmin": false,
      "uri": "/v1/user/1899208",
      "email": "[e-mail]",
      "username": "Julianne.Doe"
    
  ]

从这个 API 中，你知道 Julianne 的用户 ID 是：18314208