> ## 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 とは？

> Application Programming Interface（アプリケーション・プログラミング・インターフェース）は、異なるソフトウェアアプリケーション同士がやり取りしてデータを交換できるようにする仲介役です。

<div id="a-simple-analogy-a-restaurant-a-waiter">
  # わかりやすいたとえ: レストランとウェイター
</div>

レストランで食事をしていると想像してください。

1. **お客であるあなた**は、メニューを眺めてチーズバーガーとフライドポテトを注文します（カートデータのリクエストを行うのと同じです）。
2. \*\*ウェイター（API）\*\*が注文を受け取り、キッチンに伝えます（API がリクエストを受け取ってサーバーに送るのと同じです）。
3. \*\*キッチン（サーバー）\*\*が注文を処理し、必要な材料を集めて料理を作ります（サーバーがカートデータを取得・操作するのとよく似ています）。
4. \*\*ウェイター（API）\*\*が料理をテーブルに運び、あなたは食事を楽しめます（API がリクエストされたデータを返してカートを更新するのと同じです）。

このたとえは、特に API に初めて触れる方にとって、その仕組みを簡単に理解する方法になります。Upcart の API を使うときは、レストランでの注文のように考えてみてください。カートに何をさせたいかを決めれば、あとは API が処理してくれます。

Upcart の API がストアをどう進化させられるかは、[API ドキュメント](/ja/upcart/introduction_to_upcarts_public_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 のカスタム 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) – Web ストアで API がどのように機能するかを理解できます
* Shopify 開発者ドキュメント – [Shopify AJAX API](https://shopify.dev/docs/api/ajax)（Upcart を Shopify のカートと連携させるマーチャントに役立ちます）

Upcart の API は Postman のような外部ツールを必要とせずにシームレスに動作します。Upcart のカスタム HTML 設定または Shopify テーマコード内で直接使用できます

***

<div id="need-assistance">
  ## サポートが必要ですか？
</div>

API が初めてでも心配ありません！JavaScript をゼロから書く必要はなく、あらかじめ用意されたスクリプトを Upcart のカスタム HTML 設定にコピー＆ペーストするだけで、数分でカートをカスタマイズできます。

どこから始めればいいかわからない場合は、[Shopify エキスパート](https://www.shopify.com/partners/directory)に相談するか、[API ドキュメント](/ja/upcart/introduction_to_upcarts_public_api)をご覧ください。

***