---
title: "X-point Cloudの使い方｜REST APIの認証と書類作成をPythonで実装、料金とAgileWorksとの違い【2026年11月】"
url: "https://www.issoh.co.jp/tech/details/20096/"
published: 2026-11-22
updated: 2026-11-22
categories: ["業務システム"]
publisher: "株式会社一創"
---

# X-point Cloudの使い方｜REST APIの認証と書類作成をPythonで実装、料金とAgileWorksとの違い【2026年11月】

X-point（エクスポイント）は、株式会社エイトレッドが提供するワークフローシステムで、現在の主力はクラウド版のX-point Cloudです。紙の申請書と同じ見た目のフォームで申請・承認・決裁を回せる製品で、REST APIとWebhookを使えば、基幹システムや勤怠・会計のデータから申請書類を自動で作ることも可能です。この記事では、2026年11月時点の公式情報をもとに、人数別の料金の実額、APIトークンとOAuth2による認証の設定、書類作成APIを呼ぶcurlとPythonのコード、承認結果を外部へ返す設計を順に追います。最後に、同じエイトレッドのAgileWorksとの違いと、連携を自社で組むべき場面を示します。

## まとめ：X-point CloudのAPI連携で押さえる認証方式・書類作成の制約と製品選定の結論

X-point Cloudの料金は、税抜で基本サービス月額20,000円に、1ユーザーあたり月額500円が加わる形です。50人なら月額45,000円、300人なら月額170,000円になり、グループウェア連携などのオプションはこれとは別に加算されます。

APIの認証は2種類あります。サーバー間で決まった処理を回すならAPIトークン、利用者本人の権限で操作させるならOAuth2のアクセストークンを使います。書類作成APIでは、フォームに設定した自動計算・マスタ検索・入力値の書式チェックが動きません。送る側のプログラムで値を計算し、書式をそろえてから送る設計が前提です。

製品の選び方は単純です。利用者が数百人規模で、紙の帳票をそのまま電子化したいならX-point Cloud。利用者が数百人を大きく超え、組織改編のたびに人事データの履歴に合わせて承認経路を切り替えたいならAgileWorksが候補になります。

## X-point Cloudでできることと2026年時点の製品構成・料金の実額を確認する

X-pointという名前は、オンプレミス版とクラウド版の両方を指してきました。いま新規に検討する対象はクラウド版だけなので、最初に製品の区分と、契約したときに毎月いくらかかるかを確かめます。

### X-point CloudとAgileWorksの位置づけ、オンプレミス版の販売終了時期

エイトレッドの[X-point Cloudの製品ページ](https://www.atled.jp/xpoint%5Fcloud/)によると、X-point Cloudは初期費用0円・保守不要で、最短5営業日で使い始められるクラウド型のワークフローです。導入社数は5,000社以上と案内されています。自社サーバーにインストールするオンプレミス版のX-pointは2022年3月31日で新規販売を終了しており、サポートは2027年3月までと同じページに記載があります。

オンプレミス版を使い続けている会社は、2027年3月までにX-point Cloudへ移るか、別の製品へ移るかを決める必要があります。同じ会社のもう1つのブランドがAgileWorksで、組織改編や業務変更に強いことを打ち出した製品です。両者の違いは後半の章で比べます。

### 基本サービス月額2万円と1ユーザー500円：人数別の月額とオプションで増える費用

[X-point Cloudの料金・プラン](https://www.atled.jp/xpoint%5Fcloud/plan%5Fprice/)（税抜・2026年11月22日時点）は、月額のスタンダードと年額のプリペイドの2プランです。スタンダードは基本サービス20,000円＋ユーザー数×500円が毎月かかり、プリペイドは基本サービス228,000円＋ユーザー数×475円×12か月を年額で払います。基本容量は1TBです。

| 利用人数 | スタンダード月額 | 連携オプション込み |
| ---- | -------- | --------- |
| 10人  | 25,000円  | 26,500円   |
| 50人  | 45,000円  | 52,500円   |
| 100人 | 70,000円  | 85,000円   |
| 300人 | 170,000円 | 205,000円  |

「連携オプション込み」は、Google WorkspaceやSharePointとの連携サービスをユーザープラン（1ユーザー月額150円）で足した場合の試算で、300人の行だけは安くなる固定プラン（月額35,000円）で計算しています。連携サービスには固定プラン（Google Workspace連携などは月額35,000円）もあり、約233人を超えると固定プランのほうが安くなります。人数が少ない会社ほど基本サービス20,000円の比重が大きく、10人では1人あたり月額2,500円になる点は見落とされがちです。ワークフロー製品の費用の比べ方は[ワークフローシステムの費用相場と自社開発との5年総額](https://www.issoh.co.jp/column/details/18033/)で整理しています。

## REST APIの認証を設定する：APIトークンとOAuth2アクセストークンの使い分け

X-point CloudのAPI仕様は、エイトレッドがGitHub Pagesで公開している[X-point REST API利用ガイド](https://atled-workflow.github.io/X-point-doc/api/doc/manual.html)と、[OpenAPI定義（Swagger UI）](https://atled-workflow.github.io/X-point-doc/api/)にまとまっています。リクエスト先は`https://{サブドメイン}.atledcloud.jp/xpoint`で、認証の方式はAPIトークンとOAuth2の2つです。

### APIトークンのヘッダを組み立てる：ドメインコード・ユーザコード・トークンのBase64

APIトークンは、管理者サイトで発行する40文字のランダム文字列です。フォームごとのトークン（フォーム管理＞APIトークン）とドメインごとのトークン（ドメイン管理＞認証情報）があり、どちらも最大10個まで発行できます。フォームごとのトークンを作るには、そのフォームに自動申請設定を事前の登録が必要です。トークンには閲覧・追加・更新・削除の4種類の権限を個別に付けられるので、申請を作るだけのプログラムには追加権限だけを渡します。

ヘッダ`X-ATLED-Generic-API-Token`には、ドメインコード・ユーザコード・トークンコードをコロンでつないでBase64にした値を入れます。ユーザコードは「誰が申請したか」の記録に使われ、書類の申請者はこのユーザになります。

```
DOMAIN=example
XP_USER=u001
XP_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
XP_HEADER=$(printf '%s:%s:%s' "$DOMAIN" "$XP_USER" "$XP_TOKEN" | base64 -w0)
echo "X-ATLED-Generic-API-Token: $XP_HEADER"
```

注意点は対象のAPIです。APIトークンで呼べるのは書類編集・承認操作のAPIだけで、システムAPI（フォーム・マスタの管理）、ユーザ別API（承認待ち件数・書類検索）、SCIM APIはアクセストークンでしか呼べません。トークンが漏れたときは、管理者サイトで権限を外すかトークンを削除すれば止められます。

### OAuth2認可コードフローとPKCEでアクセストークンを取る手順と有効期限

利用者本人の権限で操作させたい場合は、OAuth2の認可コードフローでアクセストークンを取ります。管理者サイトのドメイン管理＞認証情報でクライアントIDを生成し（ドメインごとに1つ）、認可エンドポイント`GET /xpoint/a/v1/oauth2/auth/{ドメインコード}`へ利用者を誘導する仕組みです。PKCEに対応しており、`code_challenge_method`には`S256`か`plain`を指定します。

1. 43〜128文字の`code_verifier`を作り、SHA-256でハッシュしてBase64URL化した値を`code_challenge`にする
2. 認可エンドポイントに`response_type=code`・`client_id`・`redirect_uri`・`code_challenge`を付けて利用者をリダイレクトする
3. ログイン後にリダイレクト先へ返る認可コードを受け取る（有効期間は発行から10分）
4. `POST /xpoint/a/v1/oauth2/token`に`grant_type=authorization_code`・認可コード・`code_verifier`を送り、アクセストークンとリフレッシュトークンを受け取る

アクセストークンの有効期限は3600秒（1時間）、リフレッシュトークンは発行から180日間です。夜間のバッチのように長く動かす処理では、1時間ごとに`grant_type=refresh_token`で再発行する処理を組み込みます。ログインの方式はパスワード認証・Google Workspace連携・SAML認証のいずれも利用可能です。認証まわりの共通の設計は[API連携の実装方法（認証・エラー処理・リトライ）](https://www.issoh.co.jp/tech/details/15351/)にまとめています。

## 書類作成APIで申請を自動化する：curlとPythonで下書き・申請を送るコード例

認証ができたら、まず認証不要のAPIで疎通を確かめ、次に書類作成APIで下書きを作ります。いきなり申請（`draft: false`）で送ると、承認者に通知が飛んでしまうためです。

### curlでX-point情報取得APIと書類作成APIを呼ぶ最小のリクエスト

X-point情報取得API（`GET /x/v1/service`）は認証なしで呼べ、バージョン情報や、ドメインが1つだけかどうかを確かめられます。書類作成API（`POST /api/v1/documents`）では、承認ルートコード`route_code`と書類データ`datas`が必須で、フォームはフォームコードかフォーム名称で指定します。

```
BASE=https://sub-domain.atledcloud.jp/xpoint

curl -s "$BASE/x/v1/service"

curl -s -X POST "$BASE/api/v1/documents" \
  -H "X-ATLED-Generic-API-Token: $XP_HEADER" \
  -H "Content-Type: application/json" \
  -d '{"draft": true, "form_code": "form01", "route_code": "route01",
       "datas": [{"page_no": 1, "fields": {"field1": "備品購入申請", "field2": "12345"}}]}'
```

成功すると、`docid`（書類ID）と「書類が提出されました」というメッセージがJSONで返ります。書類IDはその後の承認状況の取得や添付ファイルの追加にすべて必要になるため、呼び出した側のデータベースに必ず保存します。`fields`のキーは、フォームの各フィールドに付けたフィールドIDです。

### Pythonで基幹システムの購買データから申請書類を作り書類IDを保存する実装

基幹システムの購買依頼を、X-point Cloudの稟議書として起票する処理の例です。明細は表定義（例では`group1`）に行の配列で入れます。

```
import base64, os, requests

BASE = "https://sub-domain.atledcloud.jp/xpoint"
raw = f"{os.environ['XP_DOMAIN']}:{os.environ['XP_USER']}:{os.environ['XP_TOKEN']}"
HEADERS = {
    "X-ATLED-Generic-API-Token": base64.b64encode(raw.encode()).decode(),
    "Content-Type": "application/json",
}

def create_request(order):
    total = sum(item["qty"] * item["price"] for item in order["items"])
    body = {
        "draft": True,
        "form_code": "purchase01",
        "route_code": "route01",
        "datas": [{
            "page_no": 1,
            "fields": {
                "field1": order["title"],
                "field2": str(total),
                "group1": [
                    {"g_field1": i["name"], "g_field2": str(i["qty"]), "g_field3": str(i["price"])}
                    for i in order["items"]
                ],
            },
        }],
    }
    res = requests.post(f"{BASE}/api/v1/documents", json=body, headers=HEADERS, timeout=30)
    res.raise_for_status()
    return res.json()["docid"]
```

合計金額`total`をPython側で計算しているのは、次のh3で触れる制約のためです。応答の`docid`は購買依頼の番号とひも付けて保存し、二重起票を防ぐ目印にも使います。フォームコードやフィールドIDが分からない場合は、アクセストークンでフォーム情報取得API（`GET /api/v1/forms/{fid}`）を呼ぶと確かめられます。

### 書類作成APIで実行されない処理：自動計算・マスタ検索・書式チェックの肩代わり

利用ガイドの制限事項には、画面から申請するときには動く処理のうち、APIでは動かないものが並んでいます。実装前に押さえておくべきなのは次の4点です。

- フォームのJavaScript・自動計算・マスタ検索・書類制御・ミラー項目は実行されない
- 各フィールドの初期値は入らず、入力値の書式チェック（最小値・最大値・日付書式など）も行われない
- ファイルの添付とコメントは書類作成時に付けられず、添付ファイル追加APIとコメント追加APIを別に呼ぶ
- フォームに記述したJavaScriptからAPIを呼ぶことはできず、ブラウザからもクロスドメイン制約で呼べない

書式チェックが動かないので、数値フィールドに文字列を送っても、そのまま登録されてしまいます。申請ステップで添付が必須の承認ルートの場合は、下書きで作ってから添付ファイルを追加し、下書きを提出する順番にします。

## 承認結果を外部システムへ返す：Webhook登録と承認状況取得APIの組み合わせ

申請を作るだけでは連携の半分です。承認・差し戻し・却下の結果を基幹システムへ戻して、発注や支払いの処理を進める仕組みが残ります。

### フォーム単位のWebhook設定と、承認状況取得APIで取りこぼしを拾う設計

画面やスマホで行われた承認操作に合わせて外部へ知らせるには、フォームごとに書類Webhookを設定します。システムAPIの`POST /api/v1/system/{fid}/webhooks`で送信先URLを登録でき、送信の記録はWebhookログ取得API（`GET /api/v1/system/webhooklog`）で確認可能です。利用ガイドによると、REST APIから承認などの操作をした場合もWebhookの送信対象です。Webhookの仕組みそのものは[Webhookの仕組みとAPIとの違い](https://www.issoh.co.jp/tech/details/3289/)で解説しています。

受信側の障害やネットワークの瞬断で通知を取りこぼすことを考えると、Webhookだけに頼る設計はおすすめしません。保存しておいた書類IDを使い、承認状況取得API（`GET /api/v1/documents/{docid}/status`）を1日1回まとめて呼んで、基幹システム側の状態と食い違う書類だけを補正する処理を併用します。利用ガイドはAPIのリクエストが多いとX-pointの応答速度に影響しうると注意しているので、数分おきに全件を問い合わせる作りは避けます。連携方式の全体の選び分けは[ワークフローシステム連携の方式と設計（API・CSV・iPaaS）](https://www.issoh.co.jp/column/details/18046/)を参照してください。

## X-point CloudとAgileWorksの違いとAPI連携の内製判断基準

同じエイトレッドの製品でも、X-point CloudとAgileWorksは料金の考え方も得意な組織規模も違います。最後に製品の選び分けと、API連携を自社で作るかどうかを決めます。

### X-point Cloudのユーザー課金とAgileWorksの同時接続課金の損益分岐

[AgileWorksの料金・プラン](https://www.atled.jp/agileworks/plan%5Fprice/)（税別）は、クラウド版が基本サービス年額3,420,000円、パッケージ版が初期費用2,400,000円からと保守年額540,000円からです。ライセンスは同時接続ユーザー数で契約する方式で、組織改編に合わせて承認経路を切り替えやすい、人事システムを考慮した履歴構造を特長に挙げています。

| 比較軸      | X-point Cloud | AgileWorks       |
| -------- | ------------- | ---------------- |
| 課金単位     | 利用ユーザー数       | 同時接続ユーザー数        |
| 提供形態     | クラウドのみ        | クラウド・パッケージ       |
| 基本料金（税抜） | 月額20,000円     | クラウド年額3,420,000円 |
| 得意な場面    | 紙の帳票の電子化      | 頻繁な組織改編          |

AgileWorksクラウド版の基本サービスは月額にすると285,000円です。X-point Cloudのスタンダードが同じ額になるのは利用者530人のときで、AgileWorksは基本サービスに含まれる範囲と追加ライセンスの条件が別に決まるため単純比較はできませんが、数百人までならX-point Cloudのほうが費用を抑えやすいといえます。製品を横に並べて選ぶ手順は[ワークフローシステム比較の判断軸4つ](https://www.issoh.co.jp/column/details/17504/)と[稟議システム比較（主要製品の料金表）](https://www.issoh.co.jp/column/details/15920/)で扱っています。

### API連携を自社で組むべき3条件と、標準連携やiPaaSで済ませる場面

REST APIで連携を自社開発すべきなのは、次のどれかに当てはまる場合です。

1. 基幹システムの購買・受注データから、月に数百件以上の申請書類を自動で起票したい
2. 承認結果を受けて、基幹システム側で発注や支払いの処理を自動で進めたい
3. フォームの自動計算やマスタ検索に頼っていた値を、送る側で正しく計算する必要がある

3つ目はAPIの制約から必ず生じる作業で、ここを見落とすと金額の入っていない稟議書が承認者に届きます。[ワークフローシステム開発](https://www.issoh.co.jp/service/business%5Fsystem/workflow/)では、X-point Cloudのような既製のワークフローと基幹システムをつなぐ連携部分の設計・実装も支援しています。

逆に、承認されたらチャットに通知する、承認済みのPDFをクラウドストレージに保存する、といった定型の処理だけなら自社開発は不要です。X-point Cloudの標準のグループウェア連携や、X-pointに対応したiPaaSのテンプレートで足ります。月額費用と保守の手間を比べると、件数が少ないうちは既製の連携を使うほうが確実に低コストです。別のSaaSのAPIで同じ構成を組む例として、[ジョブカンのワークフローAPIのトークン認証とPython実装](https://www.issoh.co.jp/tech/details/20061/)も参考になります。

## よくある質問

X-point Cloudの導入とAPI連携について、検討時によく出る質問をまとめました。

### X-point CloudのAPIは追加料金なしで使えますか？

公式の料金ページには、REST APIそのものを有料オプションとして示す記載は見当たりません。製品ページでは、WebhookとREST APIによる連携を標準の機能として紹介しています。ただし、契約内容によって使える範囲が変わる可能性はあるため、APIで起票する件数や接続するシステムを伝えたうえで、契約前にエイトレッドへ確認しておくと確実です。

### X-point Cloudの最低利用人数や無料トライアルはありますか？

製品ページでは、数名規模の会社から1,000名以上の企業まで導入されていると案内されており、30日間の無料トライアルが用意されています。料金は基本サービス月額20,000円にユーザー数×500円が加わるため、人数が少ないほど1人あたりの単価は高くなります。10人なら月額25,000円で、1人あたり2,500円です。

### オンプレミス版のX-pointはいつまで使えますか？

オンプレミス版のX-pointは2022年3月31日で新規販売を終了しており、サポートは2027年3月までとされています。現在オンプレミス版を使っている場合は、フォームと承認ルートの移行にかかる期間を見込んで、X-point Cloudへの移行か他製品への乗り換えを早めに決める必要があります。

### X-point CloudのAPIをブラウザのJavaScriptから直接呼べますか？

呼べません。利用ガイドの制限事項に、クロスドメイン制約によりブラウザ上でAPIをリクエストすることはできないと書かれています。フォームに記述したJavaScriptなど、X-pointの内部から呼ぶこともできません。サーバー側のプログラムやバッチ、iPaaSなど、クロスドメイン制約を受けない環境から呼び出します。

### APIで作成した書類の申請者は誰になりますか？

APIトークンで作成した場合は、トークン情報に含めたユーザコードのユーザが申請者になります。OAuth2のアクセストークンで作成した場合は、そのトークンに結びついたユーザです。自動申請設定で指定した申請ユーザは申請者になりません。複数部署に所属する申請者の申請部署をAPIで変えることもできないため、部署ごとに申請を分けたい場合は運用で調整します。

## 関連記事

- [ワークフローシステムとは？パッケージ・クラウド・オンプレミスの違いと基幹連携・自社開発の判断基準](https://www.issoh.co.jp/column/details/15254/)：製品を選ぶ前の全体像
- [ワークフローシステム連携の方式と設計：API・CSV・DB直結・iPaaSの選び分け](https://www.issoh.co.jp/column/details/18046/)：API以外の連携方式との比較
- [API連携の実装方法：REST連携の5手順と認証・エラー処理・リトライをcurlとPythonで解説](https://www.issoh.co.jp/tech/details/15351/)：外部APIを呼ぶ処理の共通設計
- [ワークフローシステムの費用相場と内訳｜月額・初期費用・自社開発との5年総額](https://www.issoh.co.jp/column/details/18033/)：既製品と自社開発の費用比較
- [ジョブカン APIの使い方｜経費精算・ワークフローAPIのトークン認証とPython実装、勤怠連携の申込手順【2026年11月】](https://www.issoh.co.jp/tech/details/20061/)：別のワークフローSaaSのAPI実装

---

出典: [X-point Cloudの使い方｜REST APIの認証と書類作成をPythonで実装、料金とAgileWorksとの違い【2026年11月】](<https://www.issoh.co.jp/tech/details/20096/>)（株式会社一創）
