バッチ・API開発 Batch・API

LYZONでは、様々なシステムとのデータ連携開発実績が豊富にあります。特に、Webサイトで扱う会員情報や商品情報をCRMやPIMなどのシステムと連携させることや、CMSのコンテンツを様々なデバイスと連携するためのAPI開発を行うことが可能です。
連携するデータの種類や量、業務の特性に応じてリアルタイムのAPI連携とするか、バッチでの一括連携とするかなど、最適な連携方法を設計できます。

1. APIを利用したWebアプリケーション開発

SaaSや基幹システムが提供する外部APIを活用して、業務アプリケーションを開発します。
既存のクラウドサービスや社内システムの力を引き出しながら、業務にフィットした柔軟なUI/UXを提供します。

2. API開発（他システムへの連携用API開発）

社内データベースや業務ロジックをAPIとして外部公開・他システム連携可能にします。
マイクロサービス化やSaaS間連携に対応し、情報のリアルタイム活用を実現します。

3. バッチ開発（定期・一括処理）

夜間処理・一括変換・ファイル連携などの定期処理を自動化するバッチアプリケーションを開発します。
レガシーシステムとの連携や、SaaS導入後の“隙間”も補完できます。

4. システム連携のシステムアーキテクトの設計支援

APIやバッチを含めて、どのように複数のサブシステムと連携したほうが良いか、設計を支援します。
システム全体像を見据えて、設計することが重要で、様々な経験やノウハウが必要です。

API開発、バッチ開発を通して解決できる課題

異なるシステム間のスムーズな連携を実現

• SFA/CRM、PIM、ERP、販売管理、などの基幹システムとのデータ連携
• Salesforce、kintone、freeeなどSaaSとのAPI統合

複雑な業務フローをバッチ処理で自動化

• 夜間・定期処理、ファイル変換、データ転送などのスケジュールバッチ処理
• 分散したデータの統合や整形処理にも柔軟に対応

よくある開発例

商品情報の一括連携

大量の商品情報を日次バッチでPIMからCMSなどのシステムに連携を行います。データ量が多い場合、前回連携した情報をもとにした差分データのみの連携が望ましいですが、システムの制約を考慮したうえで連携手法の設計を行います。また、連携元のデータ構造が連携先のシステムで扱うのに適さない場合は、連携データを整形した中間DBを作ることで連携先システムで最適なパフォーマンスを実現することが可能になります。

会員情報のリアルタイム連携

会員サイトでの行動（会員登録やログイン、申込みなど）をCRMなどのシステムにリアルタイムで連携します。連携先としてSalesforceやDynamicsなどのCRMだけでなく、KARTEやSalesforce Marketing CloudなどのマーケティングツールやTreasure DataやSnowflakeなどのCDPツールとの連携も可能です。

CMSコンテンツの連携API開発

CMSに登録されているキャンペーン情報やお知らせ情報などを様々なデバイス・システムに連携するためのAPI開発を行います。スマホアプリやECサイトなどに表示されるコンテンツをCMSで一元管理し、API連携することでシームレスにお客様に情報を提供することが可能になります。
また、API開発における標準的なルールや設計方針（RESTfulなど）が整備されているため、低価格で高品質なAPI開発が実現可能となっています。

その他連携開発

様々なお客様の要望や業務特性に応じてシステム間のデータ連携を開発することができます。

• SNSとの連携、郵便番号検索といったWebサイト上で利用するデータの連携
• 予約システムとカレンダー・通知系サービスの統合
• CMSとプロジェクト管理システム（Backlogなど）の連携
• 業務SaaSのAPIを活用した申請・承認フロー構築
• 社内システムとWebポータルの双方向データ連携
• ECサイトと在庫管理/配送システムの連携
• Excel/CSVを介したレガシー業務の自動化・変換
• データベース間のETL処理設計

バッチ開発は、決まったタイミングで大量のデータ処理を自動実行する仕組みを作ること、API開発は、システム同士がデータや機能をやり取りできる窓口を作ることを指します。どちらもシステム間連携や業務自動化に欠かせない重要な技術です。

マイクロサービス化に伴うAPI開発の重要性

マイクロサービスという開発手法が浸透し、これまでのモノリスで作られたシステムに比べて格段にAPI開発の重要性が高まってきています。
マイクロサービスは、柔軟性・拡張性が高いというメリットがある反面、APIでの連携が必須になるため、API設計の品質がシステム全体の品質に直結します。

そのため、マイクロサービスでシステムを構築する場合、開発業者がどの程度API開発や連携開発に精通しているかが重要なポイントになります。

システム・データのサイロ化の影響

システムが部署ごとに分かれ、データが連携されていないサイロ化が発生すると個々のデータの真価が発揮できず、データが整理されていない状態だと今後のAI活用への影響も出てきてしまいます。

その状態を改善し、データドリブンでのスピーディーな意思決定をするためにもAPIでのデータ連携やバッチ等でのデータ統合が経営的にも重要なテーマとなります。

API開発における標準ルール

API開発において、統一のルールに基づいて設計することが他システムとの連携しやすさに繋がり、運用性においても効果を発揮します。
LYZONでは一般的なRESTの原則（ステートレス、統一インターフェース、レイヤーシステムなど）に則りつつ、更に一段階深堀りした独自のルールを設けることで、より一貫性があり、保守性に優れるAPIを開発することが可能になっています。

APIのエラーハンドリングの重要性

APIの品質を向上させるために必須なことは、予期せぬエラーが起きた際の振る舞いです。
特にマイクロサービスで細分化したシステムにおいて、一部のサービスでエラーが発生したときにシステム全体に影響が出ない（問題を悪化させない）ような仕組みが必要になります。
その仕組みの代表例がサーキットブレーカーというパターンになり、エラーが発生したシステムに継続的にリクエストが繰り返されないようにすることで、システムの健全性を保つことに繋がります。
ただし、システムの特性によっては一時的なエラーになるケースを考慮して、再試行パターンを採用し、正常になるまでリトライを繰り返した方が良い例もあるため、LYZONではシステムの全体最適を考慮し、エラーハンドリングのパターンを組み合わせて設計を行うようにしております。

また、バッチ処理で大量のデータを一括で連携する際のエラーハンドリングで特に考慮が必要なポイントはロールバックです。
仮に100件のデータ連携時に50件目でエラーが発生した際、49件のデータの連携が成功したままになってしまうと、連携元とのデータの整合性が保たれなくなってしまうため、成功した49件のデータをもとに戻すロールバックの処理が必要になります。

データ連携時のログ設計

データ連携時において、ログの設計も大切なポイントになります。
システム間のデータ連携で失敗した際、どこでエラーが起こり連携に失敗したのかを判断するためにはログの確認が必要不可欠です。
そのため、適切にログが出力されていないとエラーの原因を追うことが難しくなってしまいます。

よくあるケースとして、API連携を行う際、システム間にAPIゲートウェイを設けることがありますが、このような環境でAPI連携に失敗した際、どこのシステムに問題があったかを特定することは複雑になるため、以下のようなチェックポイントを確認できるログ出力が必要になります。

ただし、連携の頻度やデータ量が多い処理の場合、すべてのチェックポイントに対するログを出力してしまうと、大量のログが出力され、逆に分かりづらいログになってしまったり、サーバーのディスクを逼迫させる原因となってしまうため、システム・業務の要件に応じて適切にログ出力を設計することはとても重要な要素になります。

ログ出力する内容の例

• DEBUG：リクエストやレスポンスの内容を出力
• INFO：リクエストやレスポンスしたことを出力
• WARN：処理継続可能な例外が起きたことを出力
• ERROR：処理継続不可能な例外が起きたことを出力

APIを利用、開発する検討ポイント

APIを設計するにあたり、検討すべき重要なポイントがあります。

1. APIのプロトコル：REST、GraphQL、SOAPなど
   • 互換性：連携先で対応できるプロトコルを設計時に確認する
2. 認証、認可の方式： OAuth2.0、OpenID Connect（OIDC）、SAMLなど
   • 互換性とセキュリティを担保するために必要
3. データ形式：JSON、XML、Protobufなど
   • フロント/外部連携先とのパフォーマンスに関わる
4. エラーハンドリング方針
   • APIの成功/失敗時のレスポンス形式とステータスコードの定義
   • エラー時のメッセージ設計やエラーコード設計も統一することが重要
5. バージョンニング設計
   • 長期運用を見据えて、APIの互換性をどのように保つか
   • URLにバージョンを含める（例：/api/v1/） or Headerやパラメータで管理
6. ログ対応/モニタリング設計
   • APIの呼び出しログ、エラー発生率、レスポンス時間などを監視・分析する仕組み
   • CloudWatch、Datadog、Azure Monitorなどのモニタリングツールとの連携が必要
7. スケーラビリティと可用性設計
   • 負荷分散（ロードバランサ）、水平スケール対応、フェールオーバーの設計
   • キャッシュ（API Gateway、CDN、Redisなど）活用の有無

その他、Webアプリケーション連携開発　周りで重要なポイント

1. セッション管理の方式
   • セキュリティ、スケーラビリティ、ユーザー体験、インフラ構成、他システムの状況によって最適な設計が変わってくる
2. CORS（クロスオリジン）ポリシー
   • フロントエンドとバックエンドが別ドメインになる場合、ブラウザの制約を意識した設定が必須
   • 適切なAccess-Control-Allow-Originなどの設定
3. レートリミット/スロットリングの設計
   • 想定外のアクセス増加、DoS攻撃、誤操作への防御策
   • 例えば、API Key単位、IPアドレス単位でのアクセス制限
4. ドキュメント公開・仕様定義方式
   • OpenAPI (Swagger)、GraphQL SDL、Postman Collectionなどで仕様を明文化
   • 利用者（フロントエンド、外部企業、SaaS利用者）が理解しやすいように整備