PHP示例

使用PHP Verion 5.2.13编写此代码和这些示例。 PHP配置了--With-Curl选项和启用JSON。看 PHP JSON. 和 PHP卷曲有关PHP功能的详细信息。

截至2014年10月，Secure_Token请求不再支持SSL V3。您可以通过调用“curl_setopt（$ connection，curlopt_sslversion，curl_slversion_tlsv1）;“ - 请注意，您可能还需要添加”CURLOPT_SSL_CIPHER_LIST => 'TLSv1'“到你的pphttpconfig.php - 如上所述这个stackoverflow答案.

fetch_token示例
add_fixed_price_item示例
add_multiple_fixed_price_items示例
revise_fixed_price_item示例示例
get_unlisted_Item示例
Update_Booth示例
get_checkout_link示例
get_user_profile示例
get_single_item示例
get_multiple_items示例
get_booth示例
get_booth_items示例
get_categories例子
get_category_traits示例
find_items_by_keards示例
set_notification_preference例子
update_inventory示例

php示例fetchtoken

fetchtoken API调用没有任何输入。此呼叫是安全的API请求，并要求DEV名称和CERT名称标头。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印令牌。打印完整的响应。

$dev_name = "xxx";
$cert_name = "yyy";
$url = "//api.sanyili.com/api_requests/secure_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);
$ args. = array();
$ post_fields. = "fetchtoken.Request";
echo "Request: $ post_fields. \n";
$connection = curl_init($url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
$token = $响应['fetchtoken.Response']['authToken'];
echo "Token: $token \n";
echo "Response: \n";
print_r($响应);

Request: fetchTokenRequest
Token: GTL0jWeQat
Response:
Array
(
  [fetchTokenResponse] => Array
      (
          [hardExpirationTime] => 2011-12-16T06:20:58.000Z
          [authenticationURL] => //www.sanyili.com/login?apitoken=GTL0jWeQat
          [authToken] => GTL0jWeQat
      )
  [timestamp] => 2010-12-16T06:20:58.000Z
  [version] => 1.0beta
  [ack] => Success
)

PHP示例AddFixedPriceItem

通过提供标题，价格，数量，描述，图片，类别和运输$ arg，将项目添加到波兰琴。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是安全的API请求，并需要开发名称和证书名称标头。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印出项目ID。打印完整的响应。

$dev_name = "xxx";
$cert_name = "yyy";
$token = "zzz";
$url = "//api.sanyili.com/api_requests/secure_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);
$item['title'] = "My Item";
$item['price'] = 30.57;
$item['quantity'] = 1;
$item['description'] = "This item is great.  Any html here.";
$item['pictureDetails']['pictureURL'] = "http://www.google.com/images/logos/ps_logo2.png";
$item['primaryCategory']['categoryId'] = 377;
$item['itemSpecifics']['specifics'] = array();
$item['itemSpecifics']['specifics'][] = array('Condition', 'New');
$item['itemSpecifics']['specifics'][] = array('Genre', 'Romance');
$item['shippingDetails']['shippingServiceOptions']['freeShipping'] = true;
$ args. = array("item" => $item);
$ args.['requesterCredentials']['bonanzleAuthToken'] = $token;
$ post_fields. = "AddFixedPriceItem.=" .  urlencode(json_encode($ args.));
echo "Request: $ post_fields. \n";
$connection = curl_init($url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
$itemId= $响应['AddFixedPriceItem.Response']['itemId'];
echo "itemId: $itemId \n";
echo "Response: \n";
print_r($响应);

Request: addFixedPriceItem={"item":{"title":"My Item","price":30.57,"quantity":1,"description":"This item is great.  Any html here.","pictureDetails":{"pictureURL":"http:\/\/www.google.com\/images\/logos\/ps_logo2.png"},"primaryCategory":{"categoryId":377},"shippingDetails":{"shippingServiceOptions":{"freeShipping":true}}},"requesterCredentials":{"bonanzleAuthToken":"zzz"}}
itemId: 24018227
Response:
Array
(
  [timestamp] => 2010-12-16T06:40:01.000Z
  [addFixedPriceItemResponse] => Array
      (
          [sellingState] => Ready for sale
          [categoryId] => 377
          [itemId] => 24018227
      )
  [version] => 1.0beta
  [ack] => Success
)

PHP示例用于AddMultipleFixedPriceItems

添加多个固定价格项目是添加单个项目，并添加每个项目到外部项目数组。

$dev_name = "xxx";
$cert_name = "yyy";
$token = "zzz";
$url = "//api.sanyili.com/api_requests/secure_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);

$items = array();
$item0['title'] = "My Item 0";
$item0['price'] = 30.57;
$item0['quantity'] = 1;
$item0['description'] = "This item is great.  Any html here.";
$item0['primaryCategory']['categoryId'] = 397;
$items[] = array("item" => $item0);  # important step is to identify each item with an "item" key

$item1['title'] = "My Item 1";
$item1['price'] = 30.57;
$item1['quantity'] = 1;
$item1['primaryCategory']['categoryId'] = 397;
$item1['description'] = "This item is great.  Any html here.";
$items[] = array("item" => $item1);  # important step is to identify each item with an "item" key

$ args. = array("items" => $items);
$ args.['requesterCredentials']['bonanzleAuthToken'] = $token;
$ post_fields. = "AddMultipleFixedPriceItems.=" .  urlencode(json_encode($ args.));

echo "Request: $ post_fields. \n";
$connection = curl_init($url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);

$json_response = curl_exec($connection);

if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}

curl_close($connection);

$响应 = json_decode($json_response,true);
$itemId= $响应['AddFixedPriceItem.Response']['itemId'];
echo "itemId: $itemId \n";
echo "Response: \n";
print_r($响应);

ReviseFixedPriceItem的PHP示例

修改项目 24018227 更新标题，价格和数量 $ args.。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是安全的API请求，并需要开发名称和证书名称标头。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印完整的响应。

$dev_name = "xxx";
$cert_name = "yyy";
$token = "zzz";
$url = "//api.sanyili.com/api_requests/secure_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);
$itemId = 24018227;
$item = array();
$item['title'] = "My Item - revised";
$item['price'] = 30.99;
$item['quantity'] = 2;
$ args. = array("item" => $item, "itemId" => $itemId);
$ args.['requesterCredentials']['bonanzleAuthToken'] = $token;
$ post_fields. = "ReviseFixedPriceItem.=" .  urlencode(json_encode($ args.));
echo "Request: $ post_fields. \n";
$connection = curl_init($url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "Response: \n";
print_r($响应);

Request: reviseFixedPriceItem={"item":{"title":"My Item - revised","price":30.99,"quantity":2},"itemId":24018227,"requesterCredentials":{"bonanzleAuthToken":"zzz"}}
Response:
Array
(
  [timestamp] => 2010-12-16T09:29:01.000Z
  [reviseFixedPriceItemResponse] => Array
      (
          [sellingState] => Ready for sale
          [categoryId] => 377
          [itemId] => 24018227
      )
  [version] => 1.0beta
  [ack] => Success
)

GetunlistedItem的PHP示例

获取包含项目ID的未列出的项目的详细信息 24018222。您还需要提供授权令牌 $ args.。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是安全的API请求，并需要开发名称和证书名称标头。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印完整的响应。

$dev_name = "xxx";
$cert_name = "yyy";
$token = "zzz";
$url = "//api.sanyili.com/api_requests/secure_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);
$itemId = 24018222;
$ args. = array("itemId" => $itemId);
$ args.['requesterCredentials']['bonanzleAuthToken'] = $token;
$ post_fields. = "getunlisteditem=" .  json_encode($ args.);
echo "Request: $ post_fields. \n";
$connection = curl_init($url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "Response: \n";
print_r($响应);

UpdateBooth的PHP示例

UpdateBooth呼叫只有1个输入，这是令牌。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是安全的API请求，并需要开发名称，证书名称和授权令牌。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印响应。

$dev_name = "xxx";
$cert_name = "yyy";
$token = "zzz";
$url = "//api.sanyili.com/api_requests/secure_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);
$ args. = array();
$ args.['requesterCredentials']['bonanzleAuthToken'] = $token;
$ post_fields. = "updatebooth.Request=" .  json_encode($ args., JSON_HEX_AMP);
echo "Request: $ post_fields. \n";
$connection = curl_init($url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "Response: \n";
print_r($响应);

Request: updateBoothRequest={"requesterCredentials":{"bonanzleAuthToken":"zzz"}}
Response:
Array
(
  [updateBoothResponse] => Array
      (
          [success] => 1
          [resultMessage] => Booth queued for update
      )
  [timestamp] => 2010-12-11T17:05:20.000Z
  [version] => 1.0beta
  [ack] => Success
)

GetCheckoutLink的PHP示例

获取3项404027,404175和23997948的结帐链接。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是标准API请求，只需要DEV命名标题。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印出链接。打印完整的响应。

$dev_name = "xxx";
$api_url = "//api.sanyili.com/api_requests/standard_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name);
$ids = array(404027,404175,23997948);
$ args. = array("itemIds" => $ids);
$ post_fields. = "getCheckoutlink.Request=" .  json_encode($ args.);
echo "Request: $ post_fields. \n";
$connection = curl_init($api_url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
$url = $响应['getCheckoutlink.Response']['checkoutUrl'];
echo "url: $url  \n";
echo "Response: \n";
print_r($响应);

Request: getCheckoutLinkRequest={"itemIds":[404027,404175,23997948]}
url: //www.sanyili.com/offers/make_cart_from_items?item_ids=404027,404175,23997948
Response:
Array
(
  [timestamp] => 2010-12-15T12:51:30.000Z
  [getCheckoutLinkResponse] => Array
      (
          [checkoutUrl] => //www.sanyili.com/offers/make_cart_from_items?item_ids=404027,404175,23997948
      )
  [version] => 1.0beta
  [ack] => Success
)

GetUserProfile的PHP示例

使用“Hollee”的ID获取用户的反馈和评级信息。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是标准API请求，只需要DEV命名标题。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印出用户评级和明星信息。打印完整的响应。

$dev_name = "xxx";
$api_url = "//api.sanyili.com/api_requests/standard_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name);
$ args. = array("userId" => "BluePennyLady");
$ post_fields. = "GetUserProfile.Request=" .  json_encode($ args., JSON_HEX_AMP);
echo "Request: $ post_fields. \n";
$connection = curl_init($api_url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
$rating = $响应['GetUserProfile.Response']['feedbackHistory']['averageRatingDetails']['rating'];
$star = $响应['GetUserProfile.Response']['user']['feedbackRatingStar'];
echo "Rating: $rating  Star: $star \n";
echo "Response: \n";
print_r($响应);

Request: getUserProfileRequest={"userId":"hollee"}
Rating: 99.9  Star: Red
Response:
Array
(
  [getUserProfileResponse] => Array
      (
          [feedbackHistory] => Array
              (
                  [uniquePositiveFeedbackCount] => 5000
                  [uniqueNeutralFeedbackCount] => 8
                  [uniqueNegativeFeedbackCount] => 3
                  [averageRatingDetails] => Array
                      (
                          [rating] => 99.9
                          [ratingCount] => 4997
                      )
              )
          [user] => Array
              (
                  [newUser] => true
                  [feedbackRatingStar] => Red
                  [aboutMeURL] => //www.sanyili.com/users/2163/profile
                  [userId] => 2163
                  [feedbackDetailsURL] => //www.sanyili.com/users/2163/user_feedbacks
                  [status] => active
                  [registrationDate] => 2008-09-02T06:33:06.000Z
              )
      )
  [timestamp] => 2010-12-15T12:23:31.000Z
  [version] => 1.0beta
  [ack] => Success
)

GetSingleItem的PHP示例

获取Bonanza Item ID 23266642的数据。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是标准API请求，只需要DEV命名标题。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印响应。

$dev_name = "xxx";
$api_url = "//api.sanyili.com/api_requests/standard_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name);
$ args. = array("itemId" => "23266642");
$ post_fields. = "getsingleitem.Request=" .  json_encode($ args., JSON_HEX_AMP);
echo "Request: $ post_fields. \n";
$connection = curl_init($api_url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "Response: \n";
print_r($响应);

GetMultipleItems的PHP示例

获取具有404027和404175的ID的2个Bonanza项目的数据。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是标准API请求，只需要DEV命名标题。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。循环通过返回的数据并打印每个项目的价格和标题。打印完整的响应。

$dev_name = "xxx";
$api_url = "//api.sanyili.com/api_requests/standard_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name);
$ids = array(404027,404175);
$ args. = array("itemId" =>  $ids);
$ post_fields. = "getMultipleItems.Request=" .  json_encode($ args., JSON_HEX_AMP);
echo "Request: $ post_fields. \n";
$connection = curl_init($api_url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "  Loop thru the data \n";
while (list(,$item) = each($响应['getMultipleItems.Response']['item'])) {
  echo "  " . $item['currentPrice'] . " - " . $item['title'] . "\n";
}
echo "Response: \n";
print_r($响应);

Getbooth的PHP示例

获取用户ID“TABE_DELIVERED”的展位。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是标准API请求，只需要DEV命名标题。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印响应。

$dev_name = "xxx";
$api_url = "//api.sanyili.com/api_requests/standard_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name);
$ args. = array("userId" => "rooms_delivered");
$ post_fields. = "Getbooth.Request=" .  json_encode($ args., JSON_HEX_AMP);
echo "Request: $ post_fields. \n";
$connection = curl_init($api_url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "Response: \n";
print_r($响应);

Request: getBoothRequest={"userId":"rooms_delivered"}
Response:
Array
(
  [timestamp] => 2010-12-15T06:41:27.000Z
  [getBoothResponse] => Array
      (
          [store] => Array
              (
                  [subscriptionLevel] => 0
                  [name] => rooms-delivered's booth
                  [url] => http://www.sanyili.com/booths/rooms_delivered
                  [logo] => Array
                      (
                          [url] => http://bonanzapublic.s3.amazonaws.com/images/booth/template_images/Paintbrushes.jpg
                      )
                  [lastUpdated] => 2010-12-06T15:58:15.000Z
                  [policies] =>
                  [description] =>
                  [syndicated] => false
              )
      )
  [version] => 1.0beta
  [ack] => Success
)

GetboothItems的PHP示例

通过提供展位ID和 - 可选地检索来自指定展位的项目 - 所需项目的状态。您可以通过指定页码来检索和/或每页列出的项目数量来通过展位中的所有项目页面 $ args..

在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是安全的API请求，并需要开发名称和证书名称标头。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印出项目ID。打印完整的响应。

$dev_name = "xxx";
$cert_name = "yyy";
$token = "zzz";
$url = "//api.sanyili.com/api_requests/secure_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);
$ args. = array( 'userId' => 'rooms_delivered', 'itemStatus' => array('for_sale', 'ready_to_post'), 'itemsPerPage' => 10, 'page' => 2);
$ args.['requesterCredentials']['bonanzleAuthToken'] = $token;   // only necessary if specifying an itemStatus other than "for_sale"
$请求_name = "GetboothItems.Request";
$ post_fields. = "$请求_name=" . json_encode($ args.) . " \n";
echo "Request: $ post_fields. \n";
$connection = curl_init($url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  // data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "Response: \n";
print_r($响应);

Get类别的PHP示例

获取“Baby”类别（ID 2984）的子类别。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是标准API请求，只需要DEV命名标题。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。循环通过数据和打印子类别ID和名称。打印响应。

$dev_name = "xxx";
$api_url = "//api.sanyili.com/api_requests/standard_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name);
$ args. = array("categoryParent" => 2984);
$ post_fields. = "get类别Request=" .  json_encode($ args., JSON_HEX_AMP);
echo "Request: $ post_fields. \n";
$connection = curl_init($api_url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "  Loop thru the data \n";
while (list(,$category) = each($响应['get类别Response']['categoryArray'])) {
  echo "  " . $category['categoryId'] . " - " . $category['categoryName'] . "\n";
}
echo "Response: \n";
print_r($响应);

Request: getCategoriesRequest={"categoryParent":2984}
Loop thru the data
1261 - Baby >> Other
19068 - Baby >> Toys for Baby
20394 - Baby >> Bathing & Grooming
20400 - Baby >> Feeding
20416 - Baby >> Nursery Bedding
20422 - Baby >> Nursery Furniture
20433 - Baby >> Baby Safety & Health
37631 - Baby >> Potty Training
45455 - Baby >> Diapering
48757 - Baby >> Wholesale Lots
66692 - Baby >> Car Safety Seats
66697 - Baby >> Nursery Decor
66698 - Baby >> Strollers
100223 - Baby >> Baby Gear
117388 - Baby >> Keepsakes & Baby Announcements
Response:
Array
(
  [getCategoriesResponse] => Array
      (
          [categoryArray] => Array
              (
                  [0] => Array
                      (
                          [categoryName] => Baby >> Other
                          [traitCount] => 1
                          [categoryId] => 1261
                          [categoryBriefName] => Other
                          [leafCategory] => true
                          [categoryLevel] => 2
                      )
                  [1] => Array
                      (
                          [categoryName] => Baby >> Toys for Baby
                          [traitCount] => 1
                          [categoryId] => 19068
                          [categoryBriefName] => Toys for Baby
                          [leafCategory] => false
                          [categoryLevel] => 2
                      )
                  [2] => Array
                      (
                          [categoryName] => Baby >> Bathing & Grooming
                          [traitCount] => 1
                          [categoryId] => 20394
                          [categoryBriefName] => Bathing & Grooming
                          [leafCategory] => false
                          [categoryLevel] => 2
                      )
                   ....
              )
      )
  [timestamp] => 2010-12-15T07:09:09.000Z
  [version] => 1.0beta
  [ack] => Success
)

php用于getCategorytraits的示例

Get the traits for the category "Books >> Fiction Books" (ID 377). This is a LEAF category。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是标准API请求，只需要DEV命名标题。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。循环通过数据和打印特征ID和标签。打印响应。

$dev_name = "xxx";
$api_url = "//api.sanyili.com/api_requests/standard_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name);
$ args. = array("categoryId" => 377);
$ post_fields. = "getCategorytraits.Request=" .  json_encode($ args., JSON_HEX_AMP);
echo "Request: $ post_fields. \n";
$connection = curl_init($api_url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "  Loop thru the data \n";
while (list(,$trait) = each($响应['getCategorytraits.Response']['traitArray'])) {
  echo "  " . $trait['id'] . " - " . $trait['label'] . "\n";
}
echo "Response: \n";
print_r($响应);

FindItemsbyKeyWords的PHP示例

查找与关键字“Levis Boot Cut”相关的Bonanza的项目，并在页面上显示5页。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是标准API请求，只需要DEV命名标题。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。循环通过数据和打印项目位置和标题。打印完整的响应。

$dev_name = "xxx";
$api_url = "//api.sanyili.com/api_requests/standard_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name);
$paginationInput['entriesPerPage'] = 5;
$paginationInput['pageNumber'] = 1;
$ args. = array("paginationInput"=> $paginationInput, "keywords" => "Levis Boot Cut");
$ post_fields. = "findItemsbyKeywords.Request=" .  json_encode($ args.);
echo "Request: $ post_fields. \n";
$connection = curl_init($api_url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "  Loop thru the data \n";
while (list(,$item) = each($响应['findItemsbyKeywords.Response']['item'])) {
  echo "  " . $item['location'] . " - " . $item['title'] . "\n";
}
echo "Response: \n";
print_r($响应);

SetNotificationPreferences的PHP示例

指定要接收通知的传递端点，并列出要订阅的通知（例如“arksellerquestion”）。在简单关联数组中构建API请求 $ args.。 JSON编码了 $ args. 在变量中 $ post_fields.。此呼叫是安全的API请求，并需要开发名称和证书名称标头。设置HTTP标头 $标题。使用curl发送API请求。将JSON响应解码为关联数组 $响应。打印完整的响应。

$dev_name = "xxx";
$cert_name = "yyy";
$token = "zzz";
$url = "//api.sanyili.com/api_requests/secure_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);

$delivery_preferences = array();
$delivery_preferences['applicationEnable'] = "Enable";
$delivery_preferences['deliveryURLDetails'] = array(
  'deliveryURL' => "http://foo.com/notifications",
  'status' => "Enable" 
);

$subscribed_notifications = array('notificationEnable' => array());
$notification = array(
  'eventEnable' => "Enable",
  'eventType' => "askSellerQuestion",
  'detailed' => true
);
array_push($subscribed_notifications['notificationEnable'], $notification);

$ args. = array('applicationDeliveryPreferences' => $delivery_preferences, 'userDeliveryPreferenceArray' => $subscribed_notifications);
$ args.['requesterCredentials']['bonanzleAuthToken'] = $token;
$ post_fields. = "setnotificationPreferences.=" .  json_encode($ args.);
echo "Request: $ post_fields. \n";
$connection = curl_init($url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "Response: \n";
print_r($响应);

Request: setnotificationPreferences.={"applicationDeliveryPreferences":{"applicationEnable":"Enable","deliveryURLDetails":{"deliveryURL":"http:\/\/foo.com\/notifications","status":"Enable"}},"userDeliveryPreferenceArray":{"notificationEnable":[{"eventEnable":"Enable","eventType":"askSellerQuestion","detailed":true}]},"requesterCredentials":{"bonanzleAuthToken":"XehKe4HUVP"}}
Response:
Array
(
    [ack] => Success
    [version] => 1.0
    [timestamp] => 2018-02-20T11:38:49.000Z
    [setnotificationPreferences.Response] => Array
        (
            [notificationId] => 69537
            [deliveryURLsProcessed] => 1
            [eventsProcessed] => 1
        )

)

UpdateInventory.的PHP示例

更新Bonanza项目1234的价格和数量，并在同一请求中更新Bonanza项5678的数量。

$dev_name = "xxx";
$cert_name = "yyy";
$token = "zzz";
$url = "//api.sanyili.com/api_requests/secure_request";
$标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);
$updates = array();
$updates["1234"] = array("quantity" => 12, "price" => 14.99);
$updates["5678"] = array("quantity" => 3);
$ args. = array("updates" => $updates);
$ args.["requesterCredentials"]["bonanzleAuthToken"] = $token;
$ post_fields. = "UpdateInventory.=" .  urlencode(json_encode($ args.));
echo "Request: $ post_fields. \n";
$connection = curl_init($url);
$curl_options = array(CURLOPT_HTTPHEADER=>$标题, CURLOPT_POSTFIELDS=>$ post_fields.,
                CURLOPT_POST=>1, CURLOPT_RETURNTRANSFER=>1);  # data will be returned as a string
curl_setopt_array($connection, $curl_options);
$json_response = curl_exec($connection);
if (curl_errno($connection) > 0) {
  echo curl_error($connection) . "\n";
  exit(2);
}
curl_close($connection);
$响应 = json_decode($json_response,true);
echo "Response: \n";
print_r($响应);

Request: updateInventory=%7B%22updates%22%3A%7B%22782383635%22%3A%7B%22quantity%22%3A12%2C%22price%22%3A14.99%7D%2C%22782383633%22%3A%7B%22quantity%22%3A3%7D%7D%2C%22requesterCredentials%22%3A%7B%22bonanzleAuthToken%22%3A%22AnOz8BOaaP%22%7D%7D
Response:
Array
(
    [ack] => Success
    [version] => 1.1.2
    [timestamp] => 2020-02-27T15:56:52.000Z
    [updateInventoryResponse] => Array
        (
            [1234] => Array
                (
                    [success] => 1
                )
            [5678] => Array
                (
                    [success] => 1
                )
        )
)

PHP示例 - 可以加速开发的功能

PHP示例 - 基本功能

这4个功能将有助于使用PHP进行API调用。您可以在进行API调用时隐藏大量详细信息。请参阅下面的示例使用情况。

# $dev_name = developer name (ID)
# $cert_name = certificate name (ID)
function BonapititSecureApiCall($dev_name, $cert_name, $api_call_and_args) {
  $url = "//api.sanyili.com/api_requests/secure_request";
  $标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name, "X-BONANZLE-API-CERT-NAME: " . $cert_name);
  $resp = BonapititSendHttpRequest($url,$标题, $api_call_and_args);
  return $resp;
}

# $dev_name = developer ID
# $api_call_and_args - string of the form: api_call={json_data}
function BonapititStandardApiCall($dev_name, $api_call_and_args) {
  $url = "//api.sanyili.com/api_requests/standard_request";
  $标题 = array("X-BONANZLE-API-DEV-NAME: " . $dev_name);
  $resp = BonapititSendHttpRequest($url,$标题, $api_call_and_args);
  return $resp;
}

# $url - string - url of the bonanza api
# $headers - string - http headers containing X-BONANZLE-API-DEV-NAME and/or X-BONANZLE-API-CERT-NAME
# $post_fields - string - data that will be posted to the $url.
function BonapititSendHttpRequest($url, $标题, $ post_fields.) {
  $connection = curl_init();
  curl_setopt($connection, CURLOPT_URL, $url);
  curl_setopt($connection, CURLOPT_SSL_VERIFYPEER, 0);  //stop CURL from verifying the peer's certificate
  curl_setopt($connection, CURLOPT_SSL_VERIFYHOST, 0);
  curl_setopt($connection, CURLOPT_HTTPHEADER, $标题); //set the headers using the array of headers
  curl_setopt($connection, CURLOPT_POST, 1);  //set method as POST
  curl_setopt($connection, CURLOPT_POSTFIELDS, $ post_fields.);
  curl_setopt($connection, CURLOPT_RETURNTRANSFER, 1);  //set it to return the transfer as a string from curl_exec
  $响应 = curl_exec($connection);
  curl_close($connection);
  return $响应;
}

# $api_call_name - string - like UpdateBooth
# $assoc_array - array - associative array of data
function BonapititBuildRequest($api_call_name, $assoc_array) {
  $请求_name = $api_call_name . "Request";
  $json = json_encode($assoc_array, JSON_HEX_AMP);
  $请求 = $请求_name . "=" .  $json;
  return $请求;
}

PHP示例 - UpdateBooth功能的使用情况

使用bonapitit函数（上面）更新展位。建立 $请求。制作安全API调用。使用JSON解码响应。打印完整的响应。

$dev_name = "xxx";
$cert_name = "yyy";
$token = "zzz";
$ args. = array();
$ args.['requesterCredentials']['bonanzleAuthToken'] = $token;
$请求 = BonapititBuildRequest("updatebooth.",$ args.);
$json_response = BonapititSecureApiCall($dev_name, $cert_name, $请求);
$响应 = json_decode($json_response,true);
print_r($响应);

PHP示例 - 用于GetSingleItem的功能的使用

使用bonapitit函数（上面）获取项目ID 23266642.构建GetSingle项 $请求。制作标准API调用。使用JSON解码响应。打印完整的响应。

$dev_name = "xxx";
$ args. = array("itemId" => "23266642");
$请求 = BonapititBuildRequest("getsingleitem.",$ args.);
$json_response =  BonapititStandardApiCall($dev_name, $请求);
$响应 = json_decode($json_response,true);
print_r($响应);