この記事では、オリジナルのストアをGelatoのAPIと連携するための総合ガイドを紹介します。スムーズで効率的な体験を実現しましょう。

API連携の技術ドキュメント

統合プロセスに入る前に、技術チームが当社の技術ドキュメントに精通していることが重要です。アクセスはこちらから。

このドキュメントは、必要な詳細と要件をまとめた包括的なリソースです。更新や新機能が追加される場合があるので、定期的に確認しておいてください。

Gelatoダッシュボード

Gelato ダッシュボードは、Gelato API 連携に関するすべてを管理する司令塔です。ここでは次のことができます:

グローバルネットワークが提供する製品の詳しい情報。価格の詳細も含まれます。
Gelato API経由の注文を、完全にコントロール。

API連携のためのデザイン要件と商品マッピング

最適な印刷結果のために、デザイン要件に目を通しておいてください。提出するファイルがこれらのガイドラインに沿っていることを必ず確認してください。

さらに、スムーズに連携するには、製品UID と、Gelatoの標準に合わせて自社製品をマッピングする方法を明確に理解しておくことが不可欠です。

API連携のための商品、価格設定、配送

提供している製品、その仕様、地理的な制限、そして国と数量に基づく価格の詳細は、ダッシュボードからアクセスできる包括的な製品カタログをご確認ください。製品やデザインに関する詳しい情報はこちらでも見つかります。

各国でのリアルタイムの在庫状況や配送方法に基づき、送料は動的に変動するため、ダッシュボードには表示されません。送料の算出方法を詳しく知りたい場合は、こちらをご覧ください。

API連携のテスト

統合のテストを始める準備ができたら、キーを生成して、HTTPリクエストのヘッダー X-API-KEY に含めてください。これで次のことができるようになります。

見積もりをリクエスト。
テスト注文を行う（これらの注文は自動的にキャンセルされ、発送されません）。
注文ステータスを取得（サンドボックス環境では、この呼び出しは常に「キャンセル済み」ステータスを返します）。

追加のテスト機能を利用でき、API の機能をさらに探り、理解を深められます。APIポータルを使えば、連携が完全に完了する前でも見積もりを依頼したりテスト注文を行ったりできます。これにより、必要な情報の初期理解、適切な商品UIDにファイルを正しく紐づける方法、そして受け取る想定レスポンスについて、あらかじめ把握する機会が得られます。

Live環境でキーを使うと、指定した住所への出荷と配達を含む注文のフルフィルメントプロセス全体を体験でき、エンドツーエンドのテストが可能です。