> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 什么是 API？

> 应用程序编程接口（API）作为中间层，使不同的软件应用能够交互并交换数据。

<div id="a-simple-analogy-a-restaurant-a-waiter">
  # 一个简单的比喻：餐厅与服务员
</div>

想象你正在一家餐厅用餐。

1. \*\*你（顾客）\*\*浏览菜单并点了一份芝士汉堡和薯条（类似于发起获取购物车数据的请求）。
2. \*\*服务员（API）\*\*接下你的订单并传达给厨房（就像 API 接收你的请求并发送到服务器）。
3. \*\*厨房（服务器）\*\*准备你的餐点，处理订单并备齐所需食材（就像服务器检索或处理购物车数据）。
4. \*\*服务员（API）\*\*随后将餐点送到你的桌上，让你享用美食（正如 API 返回所请求的数据并更新你的购物车）。

这个比喻提供了一种理解 API 工作原理的简单方式，尤其适合初次接触 API 的人。使用 Upcart 的 API 时，可以把它想象成在餐厅点餐——决定你想让购物车做什么，剩下的交给 API 处理。

浏览我们的 [API 文档](/zh/upcart/introduction_to_upcarts_public_api)，了解 Upcart 的 API 如何为你的商店赋能。

***

<div id="how-this-relates-to-upcarts-api">
  # 这与 Upcart 的 API 有什么关系
</div>

Upcart 的 Public API 让你能够灵活地自定义和管理购物车的功能，就像给服务员下达具体指示一样。

例如，如果你想测试 Upcart 的 API 是否正常工作，可以在自定义 HTML 中运行一段简单的脚本，在购物车每次打开时记录一条消息：

```
<script>  
  window.upcartSubscribeCartOpened(() => {  
    console.log("UpCart API Test - The cart has been opened!");  
  });  
</script>
```

<div id="verifying-if-its-working">
  ## 验证是否生效
</div>

1. 打开你的商店，前往 **Upcart Settings → Custom HTML** 添加脚本。
2. 保存更改并刷新你的商店。
3. 打开浏览器控制台（Windows 上按 **F12** 或 **Ctrl + Shift + J**，Mac 上按 **Cmd + Option + J**）。
4. 打开 Upcart 购物车，你应该会在控制台中看到确认消息：

```
Upcart API Test - The cart has been opened!
```

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/api-custom-html-test-script.png?fit=max&auto=format&n=uxKAdY-e0h16xa48&q=85&s=5df59c4ceee2ee520c39b5dd861c46ec" alt="Upcart Custom HTML 测试脚本在浏览器控制台中记录购物车已打开的消息" width="1472" height="1086" data-path="images/upcart/api-custom-html-test-script.png" />

***

<div id="want-to-learn-more-about-apis">
  ## 想进一步了解 API？
</div>

如果你有兴趣深入学习 API 和 JavaScript，这里有一些适合初学者的资源可以帮助你入门。

**适合初学者的 API 与 JavaScript 学习资源：**

* [W3Schools: JavaScript Basics](https://www.w3schools.com/js/) —— 学习使用 Upcart API 所需的基础脚本知识
* [MDN Web Docs: APIs for Beginners](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Client-side_web_APIs) —— 了解 API 在网店中的工作方式
* Shopify 开发者文档 —— [Shopify AJAX API](https://shopify.dev/docs/api/ajax)（适合将 Upcart 与 Shopify 购物车集成的商家）

Upcart 的 API 无需 Postman 等外部工具即可顺畅使用——你可以直接在 Upcart 的 Custom HTML 设置或 Shopify 主题代码中使用它

***

<div id="need-assistance">
  ## 需要帮助？
</div>

如果你刚接触 API，不用担心！你不必从零开始编写 JavaScript——只需将现成的脚本复制粘贴到 Upcart 的 Custom HTML 设置中，几分钟内即可完成购物车的自定义。

不知道从哪里开始？联系一位 [Shopify Expert](https://www.shopify.com/partners/directory)，或浏览我们的 [API 文档](/zh/upcart/introduction_to_upcarts_public_api)。

***