创建账号商品 – PlayerAuctions 帮助中心

POSThttps://seller-api.playerauctions.com/api/v1/offers/account

为账号商品创建报价单。

i. 请求示例

当 isAuto 为 false 时（手动发货）


{
  "gameId": 3637,
  "serverId": 4144,
  "categoryId": 4144,
  "price": 99.99,
  "selleraftersaleprotection": 30,
  "offerDuration": 30,
  "title": "Simple Title",
  "offerDesc": "<p>Simple Description.</p>",
  "screenShot": "https://cdn-image.azureedge.net/title-image/liutest6/202606090157435743.png",
  "agreeCheck": true,
  "isAuto": false,
  "manual": {
    "loginName": "loginName",
    "retypeLoginName": "loginName",
    "choose1": true,
    "choose2": true,
    "choose3": true,
    "choose4": true,
    "choose5": true,
    "deliveryGuarantee": 5
  }
}

当 isAuto 为 true 时（自动发货）


{
  "gameId": 3637,
  "serverId": 4144,
  "categoryId": 4144,
  "price": 99.99,
  "selleraftersaleprotection": 30,
  "offerDuration": 30,
  "title": "Simple Title",
  "offerDesc": "<p>Simple Description.</p>",
  "screenShot": "https://cdn-image.azureedge.net/title-image/liutest6/202606090157435743.png",
  "agreeCheck": true,
  "isAuto": true,
  "autoDelivery": {
    "loginName": "loginName",
    "retypeLoginName": "loginName",
    "password": "123password",
    "retypePassword": "123password",
    "characterName": "CharacterName",
    "firstCDKey": "example-key",
    "isInfoSame": true,
    "original": {
      "firstName": "John",
      "lastName": "Doe",
      "phone": "0123456789",
      "email": "test@example.com",
      "city": "Shanghai",
      "country": "China"
    },
    "current": {
      "phone": "0123456789",
      "email": "test@example.com",
      "city": "Shanghai",
      "country": "China"
    },
    "choose5": true,
    "instruction": "Extra instruction.",
    "securityQuestion": "SecurityQuestion",
    "securityAnswer": "Answer",
    "retypeSecurityAnswer": "Answer",
    "parentalPassword": "password123"
  }
}

ii. 请求参数

请求体参数

参数	类型	必填	描述
gameId	int	是	游戏ID。
categoryId	int	是	阵营ID（子节点 {id})。树状结构可通过（api/v1/games/{id}/{type}/servers）接口获取。
serverId	int	是	服务器ID {id}。树状结构可通过（api/v1/games/{id}/{type}/servers）接口获取。
price	decimal	是	单价。
sellerAfterSaleProtection	int	是	卖家提供售后保障天数。可选值: 0, 7, 14, 或30。
offerDuration	int	是	商品有效期天数。可选值: 3, 7, 14, 或30。
title	string	是	商品标题。
offerDesc	string	否	商品描述。
screenShot	string	否	商品图片链接。
agreeCheck	boolean	是	是否同意 [Secure Seller Delivery Agreement] （用户发货安全协议）。必须为true（真）。
isAuto	boolean	是	是否自动发货。
manual	object	否	手动发货账号信息 (当 isAuto 为 false 时必填).
└─ loginName	string	否*	（当 isAuto 为 false 时必填）游戏账号登录名
└─ retypeLoginName	string	否*	（当 isAuto 为 false 时必填）再次输入游戏账号登录名
└─ choose1	boolean	否*	（当 isAuto 为 false 时必填）您知晓家长控制码或未设家长控制码。必须为 'true'。
└─ choose2	boolean	否*	（当 isAuto 为 false 时必填）您知晓游戏账号注册时所用的电话号码。必须为 'true'。
└─ choose3	boolean	否*	（当 isAuto 为 false 时必填）您可提供游戏账号的注册邮箱。必须为 'true'。
└─ choose4	boolean	否*	（当 isAuto 为 false 时必填）您知晓游戏账号注册时所用的用户全名。必须为 'true'。
└─ choose5	boolean	否*	（当 isAuto 为 false 时必填）您知晓游戏账号的安保问题及其答案。必须为 'true'。如未设安保问题，填'true'。
└─ deliveryGuarantee	int	否*	（当 isAuto 为 false 时必填）发货期限。通过customId设置赋值。选项列表可通过 api/v1/games/{id}/{type}/deliveryTimes 接口获取。
autoDelivery	object	否	自动发货账号信息 (当 isAuto 为 true 时必填).
└─ loginName	string	否*	（当 isAuto 为 true 时必填）游戏账号登录名。
└─ retypeLoginName	string	否*	（当 isAuto 为 true 时必填）再次输入游戏账号登录名。
└─ password	string	否*	（当 isAuto 为 true 时必填）游戏账号密码。
└─ retypePassword	string	否*	（当 isAuto 为 true 时必填）再次输入游戏账号密码。
└─ characterName	string	否	游戏内角色名称
└─ firstCDKey	string	否*	（当 isAuto 为 true 时必填）注册 CD Key（激活码）。请参考游戏列表（Game List）接口。isCDKeyRequired 字段用以指示是否需要填写此项。
└─ isInfoSame	boolean	否*	（当 isAuto 为 true 时必填）游戏账号注册时所用信息与当前账号持有人信息一致。
└─ original.firstName	string	否*	（当 isAuto 为 true 时必填）注册时填写的名
└─ original.lastName	string	否*	（当 isAuto 为 true 时必填）注册时填写的姓。
└─ original.phone	string	否*	（当 isAuto 为 true 时必填）注册时填写的手机号码。
└─ original.email	string	否*	（当 isAuto 为 true 时必填）注册时填写的电子邮箱。
└─ original.city	string	否*	（当 isAuto 为 true 时必填）注册时填写的城市
└─ original.country	string	否*	（当 isAuto 为 true 时必填）注册时填写的国家。
└─ current.phone	string	否*	（当 isAuto 为 true 时必填）当前手机号。
└─ current.email	string	否*	（当 isAuto 为 true 时必填）当前电子邮箱。
└─ current.city	string	否*	（当 isAuto 为 true 时必填）当前城市。
└─ current.country	string	否*	（当 isAuto 为 true 时必填）当前国家。
└─ choose5	boolean	否*	（当 isAuto 为 true 时必填）您知晓游戏账号的安保问题及其答案。必须为 'true'。如未设安保问题，填'true'。
└─ instruction	string	否	其余补充信息。
└─ securityQuestion	string	否*	（当 isAuto 为 true 时必填）账号保全信息：安保问题
└─ securityAnswer	string	否*	（当 isAuto 为 true 时必填）账号保全信息：安保问题答案
└─ retypeSecurityAnswer	string	否*	（当 isAuto 为 true 时必填）再次输入安保问题答案
└─ parentalPassword	string	否*	（当 isAuto 为 true 时必填）家长控制码

iii. 响应示例

成功响应

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "offerId": 71394136,
    "navigateURL": "https://www.playerauctions.com/lol-account/71394136a!simple-title/",
    "title": "Simple Title",
    "productType": "account",
    "gameName": "League of Legends",
    "productName": "Accounts",
    "screenShot": "",
    "imageBlacklist": ""
  }
}

响应报错

{
  "code": 10002,
  "message": "Invalid parameter.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

iv. 响应参数

参数	类型	描述
code	int	响应状态码。 10000表示成功，其他值表示发生错误。
message	string	响应消息。当请求失败时，该字段会包含具体的错误详情。
requestId	string	请求标识号，用以追溯。
data.offerId	int	更新后的商品 ID。
data.navigateURL	string	更新后的商品链接。
data.title	string	商品标题。
data.productType	string	商品类型。
data.gameName	string	游戏名称。
data.productName	string	商品名称。
data.screenShot	string	商品图片链接。
data.imageBlacklist	string	商品图片黑名单标识。该字段为空表示未加入黑名单。

i. 请求示例

当 isAuto 为 false 时 （手动发货）

当 isAuto 为 true 时 （自动发货）

ii. 请求参数

请求体参数

iii. 响应示例

成功响应

响应报错

iv. 响应参数

当 isAuto 为 false 时（手动发货）

当 isAuto 为 true 时（自动发货）