dolphinscheduler api调度

### 关于DolphinScheduler API调度

对于希望集成第三方系统的场景，可以利用DolphinScheduler提供的API来管理项目、流程等资源。由于涉及的API较多，建议专注于理解其大致框架与核心功能，而详细的API列表以及具体使用方式应当参照官方文档[^1]。

为了开始使用这些API，创建访问令牌（token）是一个必要的前置操作[^2]。这一步骤确保了安全性和权限控制机制的有效实施。

#### 获取并了解API文档

最直接的方式是查阅[DolphinScheduler官方网站](https://dolphinscheduler.apache.org/)上的相关资料[^4]。这里不仅提供了全面的任务调度指南，还包括了如何部署单机版环境的具体指导[^3]，这对于初步探索API非常有帮助。

#### 示例：获取Token接口请求

下面给出一段Python代码片段作为示例，展示如何向DolphinScheduler发送HTTP POST请求以获得用于后续调用其他API所需的认证Token：

import requests
from urllib.parse import urljoin


def get_token(base_url, username, password):
    endpoint = '/users/login'
    full_url = urljoin(base_url, endpoint)

    payload = {
        'userName': username,
        'userPass': password
    }

    response = requests.post(full_url, json=payload)
    
    if response.status_code == 200:
        data = response.json()
        token = data.get('data', {}).get('id')
        return f'Bearer {token}'
    else:
        raise Exception(f"Failed to obtain token: {response.text}")

此函数接收基础URL、用户名及密码参数，并返回一个带有`Bearer`前缀的字符串形式的Token，该Token可用于授权之后的所有API请求。