README

php-cupid/cupid

描述

通过 Cupid API 进行映射非常简单。首先上传您的属性清单作为参考，然后发送属性列表到 API，并直接在响应中获取结果。

安装

需要 PHP 版本 >=5.3。
推荐通过 Composer 安装 Guzzle。

composer require php-cupid/cupid

方法

注意：以下文档与 3.x 版本同步，如果您使用的是旧版本，请检查如何升级。

uploadInventory

此函数可用于使用提供的 CSV 文件上传清单。

您需要提供清单的名称，并为您的文件中的每一列匹配以下标准字段名称的索引。

假设您有一个看起来如下表的 CSV 文件

在这种情况下，表单数据将是

file: 要上传的 CSV 文件
name: Cupid 清单
header_id: 0
header_name: 1
header_address: 2
header_city: 6
header_country_code: 5
header_latitude: 3
header_longitude: 4

require  "vendor/autoload.php";
$cupid = new App\Cupid(*YOUR  API  KEY*);
$uploadInventory = $cupid->uploadInventory("my npm catalog", "./file.csv", 0, 1, 2, 3, 4, 5, 6)
var_dump($uploadInventory);

listInventories

此函数可用于列出上传到您工作区的清单。
您可以检查它们的状态和其他基本信息。

require  "vendor/autoload.php";
$cupid = new App\Cupid(*YOUR  API  KEY*);
$listInventories = $cupid->listInventories()
var_dump($uploadInventory);

inventoryDetails

此函数可用于检查请求的清单的详细信息。

您可以使用它获取清单状态 mapping_process_status_id，如下所示。状态必须是 2（完成）才能开始映射。

清单状态的 mapping_process_status_id 可能的值

当您有一个具有 active=true 和 mapping_process_status_id=2 的清单时，您可以使用以下端点进行映射

require  "vendor/autoload.php";
$cupid = new App\Cupid(*YOUR  API  KEY*);
$inventoryDetails = $cupid->inventoryDetails($inventory_id)
var_dump($inventoryDetails);

mapHotelList

此函数允许您发送属性列表并将其与您的活动清单进行映射。您将在响应中获得映射结果。

限制您可以每个请求发送最多 1000 个属性。

$cupid = new App\Cupid(*YOUR  API  KEY*);
$array = [
	[
		"address" => "123 main street",
		"country_code"=> "US",
		"hotel_code"=> "1256",
		"latitude"=> 36.18743350322336,
		"longitude"=> -115.15064193665704,
		"name"=> "hotel name"
	]
];

$mapHotels = $cupid->mapHotels($array);
print_r($mapHotels);

php-cupid / cupid

维护者

详细信息