makeshop API よくあるご質問（FAQ）

makeshop APIに関するよくある質問を掲載しています。まずは、API対応の判断フローをご確認ください。

新旧APIの管理画面・利用開始方法について

APIのご利用にあたり、新API（次世代API）と旧API（従来API）では、操作する管理画面および利用開始の手順が異なります。
以下の判断フローを進める前に、どちらのAPIをご利用中かあらかじめご確認ください。

■ 新API（次世代API）
対象管理画面：ホーム / アプリ管理 / アプリ一覧
対象アプリをインストールすることで、API連携が有効化されます。

■ 旧API（従来API）
対象管理画面：ショップ構築 / 設定 / API
該当APIの開放設定を行うことで利用が可能になります。開放設定を行わない限り、利用することはできません。
※旧APIは自社開発での新規利用受付をすでに終了しており、今後廃止予定です。お早めに次世代API（新API）への移行をご検討ください。

API対応の判断フロー

以下のフローチャートで、お問い合わせ先をご確認ください。

外部サービス連携について

Q1：外部サービス（ネクストエンジン・CROSS MALL・助ネコ・item Robot等）に関する質問はどこに聞けばよいですか。

A：ご利用中の外部サービスのサポート窓口へお問い合わせください。

外部サービスの連携方法、利用方法、設定手順、次世代APIへの切り替え、費用、決済ステータスによる注文取り込み制御など、外部サービス側の設定・仕様に関する内容は、makeshop側では詳細な案内ができません。

各サービスのマニュアルをご確認いただくか、サービス提供元のサポート窓口へお問い合わせください。必要に応じて、外部サービスからmakeshop API窓口へお問い合わせいただく流れとなります。

【重要】外部サービス連携時の注意点
外部サービス（CROSS MALL、ネクストエンジン等）との連携をご希望の場合、まずは各サービスの提供元へお問い合わせください。

■ 「API自社利用申請」は外部サービス連携では不要です
「API自社利用申請」は、ショップ様が独自にシステム開発をされる場合のみ必要な手続きです。
外部サービスとの連携では、この申請は不要です。誤って申請されないようご注意ください。

■ 外部サービスとの連携手順
多くの外部サービスは、makeshop管理画面の ホーム / アプリ管理 / アプリ一覧 からインストールすることで連携が可能です。
（例：CROSS MALL for makeshop）

※一部のサービスは限定公開のため、アプリ一覧に表示されない場合があります。その場合は、サービス提供元へ連携方法をご確認ください。

API利用環境について

Q2：自社でシステムを開発してAPIを利用していますが、どの窓口に問い合わせればよいですか。また、APIについての不明点はどこで確認すればいいですか。

A：ご利用中のAPIバージョンにより、問い合わせ先・確認先が異なります。

■ 新API（次世代API）をご利用の場合
次世代API問い合わせフォームよりお問い合わせください。
◆次世代API 問い合わせフォーム◆
 

■ 旧API（従来API）をご利用の場合
旧API窓口へお問い合わせください。
※旧APIはすでに新規受付を終了しており、今後提供終了予定となっておりますため、お早めに次世代API（新API）への移行をご検討ください。  

Q3：ショップ構築 / 設定メニュー内の「API」について、利用方法を教えてください。

A：廃止予定の旧API専用メニューとなります。ショップ様による新規のご利用は受付を終了しております。
旧APIでご利用のサービスがある場合、外部サービス提供元のサポート窓口へお問い合わせください。

Q4：新API（次世代API）をご利用の場合、対象管理画面「ショップ構築 / 設定 / API」は使用しますか。

A：新APIでは、対象管理画面：ショップ構築 / 設定 / APIは使用しません。
新API（次世代API）の対象管理画面はホーム / アプリ管理 / アプリ一覧です。対象アプリをインストールすることでAPI連携が有効化されます。
「ショップ構築 / 設定 / API」は旧API（従来API）専用のメニューとなります。
※旧APIはすでに新規受付を終了しており、今後提供終了予定となっておりますため、お早めに次世代API（新API）への移行をご検討ください。

API経由での商品・在庫連携について

Q5：API経由で商品登録したが取り込まれません。

A：ご利用中のシステム環境により、確認方法が異なります。

■ 外部サービスをご利用の場合
外部サービスのサポート窓口へお問い合わせください。

■ 自社開発で旧APIをご利用の場合
旧API経由での商品登録がうまくいかない場合は、makeshop管理画面の「商品管理 / 商品一覧 / アップロード・ダウンロード / 商品一括登録」より、必要に応じて内容を修正のうえ、CSVにて直接アップロードいただく方法もご検討ください。
※旧APIはすでに新規受付を終了しており、今後提供終了予定となっておりますため、お早めに次世代API（新API）への移行をご検討ください。

■ 自社開発で新APIをご利用の場合
実装内容に依存する技術的な問題の可能性があります。開発ご担当者様にて実装内容をご確認いただくか、次世代API問い合わせフォームよりお問い合わせください。

Q6：在庫が連携されない、またはバリエーション在庫が反映されません。

A：Q5と同様に、ご利用中のシステム環境により確認方法が異なります。

■ 外部サービスをご利用の場合
外部サービスのサポート窓口へお問い合わせください。

■ 自社開発で旧APIをご利用の場合
旧API経由での商品登録がうまくいかない場合は、makeshop管理画面の「商品管理 / 商品一覧 / アップロード・ダウンロード / 商品一括登録」より、必要に応じて内容を修正のうえ、CSVにて直接アップロードいただく方法もご検討ください。
※旧APIはすでに新規受付を終了しており、今後提供終了予定となっておりますため、お早めに次世代API（新API）への移行をご検討ください。

■ 自社開発で新APIをご利用の場合
実装仕様に依存する可能性があります。開発ご担当者様にてご確認いただくか、次世代API問い合わせフォームよりお問い合わせください。

API認証・切り替えについて

Q7：旧API（従来API）から新API（次世代API）への切り替え時の注意点を教えてください。

A：自社でAPI開発をされている場合は、以下の「新旧API移行ガイド」をご確認ください。
◆新旧API移行ガイド◆

詳細なご質問や技術的なサポートが必要な場合は、次世代API問い合わせフォームよりお問い合わせください。
◆APIや公開方法、開発申請などに関するお問い合わせ◆

Q8：認証コードを設定したが接続認証に失敗します。

A：ご利用中のシステム環境により、問い合わせ先が異なります。

■自社開発で旧APIをご利用の場合
旧APIをご利用中の場合、お問い合わせ前に「ショップ構築 / 設定 / API」より、認証コードが正しく保存されているかご確認ください。認証コードの「発行」ボタンの押下では、認証コードは保存されていません。必ず「保存」ボタンを押した上で、認証コードをご利用くださいませ。
※旧APIはすでに新規受付を終了しており、今後提供終了予定となっておりますため、お早めに次世代API（新API）への移行をご検討ください。

■ 自社開発で新APIをご利用の場合
実装仕様に依存する可能性があります。開発ご担当者様にてご確認いただくか、次世代API問い合わせフォームよりお問い合わせください。

■ 外部サービスをご利用の場合
外部サービス側の設定に起因する可能性が高いため、外部サービスのサポート窓口へお問い合わせください。

その他・お問い合わせについて

Q9：APIに関する質問がどこに該当するか判断できません。

A：上記のフローチャートをご参照いただくか、サポート一覧をご確認のうえ、お問い合わせください。適切な窓口へご案内いたします。

Q10：API利用に関する技術ドキュメントはどこで確認できますか。

A：新API（次世代API）をご利用の場合は、以下の開発者向けサイトをご確認ください。
◆makeshop Developers◆

旧API（従来API）に関する技術情報は、旧API窓口へお問い合わせください。
※旧APIはすでに新規受付を終了しており、今後提供終了予定となっておりますため、お早めに次世代API（新API）への移行をご検討ください。