> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/guides/guides-zh/kai-fa-zhe.md).

# 开发者

使用 API、Python SDK、webhook 和兼容 S3 的访问方式在 Shade 上进行开发。

开发者指南位于 [开发者](https://academy.shade.inc/developers) 部分，紧邻 API 参考文档。

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>开始使用 Python SDK</strong></td><td>安装 SDK 并进行首次调用。</td><td><a href="https://academy.shade.inc/developers">https://academy.shade.inc/developers</a></td></tr><tr><td><strong>常见模式</strong></td><td>适用于大多数集成所需任务的实用指南。</td><td><a href="https://academy.shade.inc/developers/common-patterns">https://academy.shade.inc/developers/common-patterns</a></td></tr><tr><td><strong>同步并响应文件更改</strong></td><td>让外部系统与 Shade 驱动保持同步。</td><td><a href="https://academy.shade.inc/developers/synchronizing-file-state">https://academy.shade.inc/developers/synchronizing-file-state</a></td></tr><tr><td><strong>Webhook</strong></td><td>从你自己的服务订阅 Shade 中的事件。</td><td><a href="https://academy.shade.inc/developers/webhooks">https://academy.shade.inc/developers/webhooks</a></td></tr><tr><td><strong>使用 Shade 的 S3 API</strong></td><td>将 Shade 驱动视为 S3 存储桶。</td><td><a href="https://academy.shade.inc/developers/using-shades-s3-api">https://academy.shade.inc/developers/using-shades-s3-api</a></td></tr><tr><td><strong>编写你自己的上传器</strong></td><td>从你的应用向 Shade 上传文件。</td><td><a href="https://academy.shade.inc/developers/writing-your-own-uploader">https://academy.shade.inc/developers/writing-your-own-uploader</a></td></tr></tbody></table>

{% hint style="info" %}
想在不编写代码的情况下连接一个工具？请参见 [通过 webhooks 将 Shade 连接到其他工具](/guides/guides-zh/zi-dong-hua/tong-guo-webhooks-jiang-shade-lian-jie-dao-qi-ta-gong-ju.md)，它使用自动化编辑器而不是 API。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/guides/guides-zh/kai-fa-zhe.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.