---
title: "APIエンドポイント｜CheckoutOSドキュメント | Chargezen"
description: "CheckoutOS APIエンドポイントの完全なリファレンス。Chargezen CheckoutOSドキュメント「APIリファレンス」より。"
url: "https://chargezen.com/ja/docs/checkoutos/api/endpoints"
lang: "ja"
updated: "2025-01-16"
---

Canonical URL: https://chargezen.com/ja/docs/checkoutos/api/endpoints

# APIエンドポイント

CheckoutOS APIエンドポイントの完全なリファレンス

最終更新日：2025-01-16

このリファレンスでは、利用できるすべてのCheckoutOS APIエンドポイントを説明します。すべてのエンドポイントは認証が必要で、JSONレスポンスを返します。

ベースURL

本番：`https://api.chargezen.com/v1`  
サンドボックス：`https://sandbox.api.chargezen.com/v1`

## アップセル

### アップセル一覧の取得

GET /upsells

```bash
curl -X GET "https://api.chargezen.com/v1/upsells" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response
{
  "data": [
    {
      "id": "upsell_123",
      "name": "Premium Add-On",
      "status": "active",
      "product_id": "prod_abc",
      "discount_type": "percentage",
      "discount_value": 15,
      "created_at": "2025-01-15T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 45
  }
}
```

### アップセルの作成

POST /upsells

```bash
curl -X POST "https://api.chargezen.com/v1/upsells" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium Add-On",
    "product_id": "prod_abc",
    "trigger_products": ["prod_xyz"],
    "discount": {
      "type": "percentage",
      "value": 15
    },
    "placement": "post_purchase",
    "status": "active"
  }'
```

### アップセルの取得

GET /upsells/:id

```bash
curl -X GET "https://api.chargezen.com/v1/upsells/upsell_123" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### アップセルの更新

PUT /upsells/:id

```bash
curl -X PUT "https://api.chargezen.com/v1/upsells/upsell_123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "discount": {
      "type": "percentage",
      "value": 20
    }
  }'
```

### アップセルの削除

DELETE /upsells/:id

```bash
curl -X DELETE "https://api.chargezen.com/v1/upsells/upsell_123" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## バンドル

### バンドル一覧の取得

GET /bundles

```bash
curl -X GET "https://api.chargezen.com/v1/bundles" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Query parameters:
# ?type=fixed|mix_match|build_a_box
# ?status=active|draft|archived
# ?page=1&per_page=20
```

### バンドルの作成

POST /bundles

```bash
curl -X POST "https://api.chargezen.com/v1/bundles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Skincare Starter Kit",
    "type": "fixed",
    "products": [
      { "product_id": "prod_cleanser", "quantity": 1 },
      { "product_id": "prod_toner", "quantity": 1 },
      { "product_id": "prod_moisturizer", "quantity": 1 }
    ],
    "pricing": {
      "type": "percentage_off",
      "value": 20
    }
  }'
```

## 分析

### 指標の取得

GET /analytics/metrics

```bash
curl -X GET "https://api.chargezen.com/v1/analytics/metrics?start_date=2025-01-01&end_date=2025-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response
{
  "data": {
    "total_revenue": 127450.00,
    "checkoutos_revenue": 28190.00,
    "average_order_value": 94.50,
    "upsell_acceptance_rate": 0.184,
    "orders_with_upsells": 782,
    "total_orders": 4250
  },
  "period": {
    "start": "2025-01-01",
    "end": "2025-01-31"
  }
}
```

### レポートの取得

GET /analytics/reports/:type

```bash
curl -X GET "https://api.chargezen.com/v1/analytics/reports/upsell_performance?start_date=2025-01-01&end_date=2025-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Available report types:
# - upsell_performance
# - bundle_performance
# - revenue_attribution
# - conversion_funnel
```

## 実験

### 実験一覧の取得

GET /experiments

```bash
curl -X GET "https://api.chargezen.com/v1/experiments" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Query parameters:
# ?status=running|completed|draft
# ?page=1&per_page=20
```

### 実験結果の取得

GET /experiments/:id/results

```bash
curl -X GET "https://api.chargezen.com/v1/experiments/exp_123/results" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response
{
  "experiment_id": "exp_123",
  "status": "significant",
  "winner": "variant_a",
  "variants": [
    {
      "name": "control",
      "visitors": 5000,
      "conversions": 250,
      "conversion_rate": 0.05
    },
    {
      "name": "variant_a",
      "visitors": 5000,
      "conversions": 325,
      "conversion_rate": 0.065,
      "lift": 0.30,
      "p_value": 0.001
    }
  ]
}
```

## 注文

### 注文の取得

GET /orders/:id

```bash
curl -X GET "https://api.chargezen.com/v1/orders/order_123" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response includes CheckoutOS-specific data:
{
  "order_id": "order_123",
  "shopify_order_id": "5678901234",
  "checkoutos_data": {
    "upsells_accepted": ["upsell_abc"],
    "bundles_purchased": [],
    "checkoutos_revenue": 24.99,
    "experiment_variant": "variant_a"
  }
}
```

## 設定

### 設定の取得

GET /settings

```bash
curl -X GET "https://api.chargezen.com/v1/settings" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### 設定の更新

PATCH /settings

```bash
curl -X PATCH "https://api.chargezen.com/v1/settings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "upsells": {
      "default_placement": "post_purchase",
      "max_offers_per_checkout": 2
    }
  }'
```

## エラーレスポンス

エラー形式

```json
{
  "error": {
    "code": "invalid_request",
    "message": "The request was invalid",
    "details": [
      {
        "field": "discount.value",
        "message": "must be between 1 and 100"
      }
    ]
  }
}
```

#### 一般的なエラーコード

*   400 Bad Request — 無効なパラメーター
*   401 Unauthorized — APIキーがない、または無効
*   403 Forbidden — 権限が不足
*   404 Not Found — リソースが見つからない
*   429 Too Many Requests — レート制限に到達
*   500 Internal Server Error — サーバーエラー

## 関連トピック

[

### 認証

APIキーの管理

詳しく見る



](https://chargezen.com/ja/docs/checkoutos/api/authentication)[

### Webhook

リアルタイムのイベント通知

詳しく見る



](https://chargezen.com/ja/docs/checkoutos/api/webhooks)

このページは役に立ちましたか？

さらにサポートが必要ですか？ [サポートに問い合わせる](https://chargezen.com/ja/docs/checkoutos/troubleshooting/support)