Skip to content

PHP library to integrate with DataCue's personalization API

License

Notifications You must be signed in to change notification settings

DataCueCo/datacue-php

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DataCue Integration Library

A library to enable content personalization with DataCue on your PHP based e-commerce store

Installation

Use composer to manage your dependencies and download DataCue Client:

composer require datacue/client

Usage

Please refer to our developer documentation and switch to the PHP tab to see all examples.

Basic Usage

<?php
use DataCue\Client;

$apikey = "your-api-key";
$apisecret = "your-api-secret";

$datacue = new Client(
    $apiKey,
    $apiSecret
);

$data = [
  "product_id" => "p1",
  "variant_id" => "v1",
  "main_category" => "jeans",
  "categories" => ["men","summer","jeans"],
  "name" => "cool jeans",
  "brand" => "zara",
  "description" => "very fashionable jeans",
  "color" => "blue",
  "size" => "M",
  "price" => 25000,
  "full_price" => 30000,
  "available" => True,
  "stock" => 5,
  "extra" => [
    "extra_feature" => "details"
  ],
  "photo_url" => "https://s3.amazon.com/image.png",
  "link" => "/product/p1",
  "owner_id" => "user_id_3"
];

$res = $datacue->products->create($data);

Advanced Usage

$apikey = "your-api-key";
$apisecret = "your-api-secret";
$env = "staging"; //use our test servers to try your code, default is production

$options = [
    'max_try_times' => 10, //number of times to try resending if there was a failure
    'pow_base' => 2, //used to adjust exponential backoff, best to leave this setting untouched
    'debug' => true, // If true, additional debug info is printed to the console
];

$client = new Client(
    $apiKey,
    $apiSecret,
    $options,
    $env
);

Getting your credentials

You can find your API key and secret in your dashboard

Don't have an account yet? sign up here

Exceptions

ExceedBodySizeLimitationException

Ensure that the size of each payload does not exceed 5MB. If you receive this exception, break up your request into chunks smaller than 5MB and try again.

ExceedListDataSizeLimitationException

Ensure that you don't see more than 500 items in a single batch request. If you receive this exception, break up your request into at least 500 per request and try again.

About

PHP library to integrate with DataCue's personalization API

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages