商品コメントAPI


出品中の商品に対し質問等のコメントを投稿します。
コメントがあった場合、出品者に通知されます。
商品詳細画面等で使用します。
ゲーオクConnectでも同機能を保有しています。


送信契機

商品画面等で、商品に対しコメントを投稿する場合。


送信先URL

(ホスト名)/connect_ja/auctionapi/setcomment.php


送信方式

POST送信


送信パラメータ

パラメータ名 必須 設定する内容
userid 文字 必須 ユーザ識別ID(11桁)
usertoken 文字 必須 ユーザ認証ログイン成功時の token
itemid 数値 必須 出品ID
comment 文字 必須 コメント内容(200文字以内)

送信時認証方法

ユーザトークン認証
※認証についてはAPI/Webhookについてをご参照ください。


API受信時のゲーオクConnect側での処理

商品のコメント登録を更新し、商品出品者へ通知します。


戻り値形式

JSON


戻り値パラメータ

キー名 設定される内容
rcode 実行結果
 0:成功
 -1:失敗
errorcode エラーコード(失敗時のみ有効)
apitime API実行サーバ時間(YYYY/MM/DD HH:MM:SS +0000 の形式)
commentid コメントID

▼戻り値サンプル

				{
				  "rcode":0,
				  "errorcode":0,
				  "apitime":"2015/08/15 10:24:46 +0900",
				  "commentid":1
				}
			

戻り値エラーコード

エラーコード 原因
1 userid 未設定
2 usertoken 未設定
3 itemeid 未設定
4 comment 未設定
11 認証エラー
19 その他のログインエラー
21 対象の出品IDが存在しない
22 コメント文字数が規定値(200文字以内)ではない
29 その他のデータベース更新エラー

備考

出品が終了した商品に対してコメントした場合はエラーとなる。