siftscience/sift-php

Sift Science PHP library

Friday, July 20, 2018
by lopatin
Repository
94 Watchers
13 Stars
338,911 Installations

PHP
4 Dependents
0 Suggesters
24 Forks
6 Open issues
24 Versions
9 % Grown

The README.md

Sift Bindings

Installation

With Composer

Add siftscience/sift-php as a composer dependency

```shell script composer require siftscience/sift-php, _(*1)


2. Now `SiftClient` will be autoloaded into your project.

```php
require 'vendor/autoload.php';

$sift = new SiftClient([
    'api_key' => 'my_api_key',
    'account_id' => 'my_account_id'
]);

// or

Sift::setApiKey('my_api_key');
Sift::setAccountId('my_account_id');
$sift = new SiftClient();

Manually

Download the latest release., _(*2)
Extract into a folder in your project root named "sift-php"., _(*3)

Include SiftClient in your project like this:, _(*4)

require 'sift-php/lib/SiftRequest.php';
require 'sift-php/lib/SiftResponse.php';
require 'sift-php/lib/SiftClient.php';
require 'sift-php/lib/Sift.php';


$sift = new SiftClient([
    'api_key' => 'my_api_key',
    'account_id' => 'my_account_id'
]);

Usage

Track an event

To learn more about the Events API visit our developer docs., _(*5)

Optional Params - return_score: :true or :false - return_action: :true or :false - return_workflow_status: :true or :false - return_route_info: :true or :false - force_workflow_run: :true or :false - include_score_percentiles: :true or :false - warnings: :true or :false - abuse_types: ["payment_abuse", "content_abuse", "content_abuse", "account_abuse", "legacy", "account_takeover"], _(*6)

Here's an example that sends a $transaction event to Sift., _(*7)

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->track('$transaction', [
    '$user_id' => '23056',
    '$user_email' => 'buyer@gmail.com',
    '$seller_user_id' => '2371',
    '$transaction_id' => '573050',
    '$currency_code' => 'USD',
    '$amount' => 15230000,
    '$time' => 1327604222,
    'seller_user_email' => 'seller@gmail.com',
    'trip_time' => 930,
    'distance_traveled' => 5.26,
]);

Label a user as good/bad

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->label('23056', [
    '$is_bad' => true,
    '$abuse_type' => 'promotion_abuse'
]);

Unlabel a user

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->unlabel('23056', ['abuse_type' => 'content_abuse']);

Get a user's score

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->score('23056');
$response->body['scores']['payment_abuse']['score']; // => 0.030301357270181357

Get the status of a workflow run

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->getWorkflowStatus('my_run_id');
$response->body['state']; // => "running"

Get the latest decisions for a user

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->getUserDecisions('example_user');
$response->body['decisions']['account_abuse']['decision']['id']; // => "ban_user"

Get the latest decisions for an order

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->getOrderDecisions('example_order');
$response->body['decisions']['payment_abuse']['decision']['id']; // => "ship_order"

Get the latest decisions for a session

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->getSessionDecisions('example_user', 'example_session');
$response->body['decisions']['account_takeover']['decision']['id']; // => "session_decision"

List of configured Decisions

Optional Params - entity_type: user or order or session - abuse_types: ["payment_abuse", "content_abuse", "content_abuse", "account_abuse", "legacy", "account_takeover"], _(*8)

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $this->client->getDecisions(['entity_type' => 'example_entity_type','abuse_types' => 'example_abuse_types']);
$response->isOk()

Apply decision to a user

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->applyDecisionToUser('example_user','example_decision','example_source',['analyst' => 'analyst@example.com']
$response->isOk()

Apply decision to an order

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->applyDecisionToOrder('example_user','example_order','example_decision','example_source',['analyst' => 'analyst@example.com']
$response->isOk()

Apply decision to a session

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->applyDecisionToSession('example_user','example_session','example_decision','example_source',['analyst' => 'analyst@example.com']
$response->isOk()

Creates a new webhook with a specified URL.

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->postWebhooks(["payload_type" => "ORDER_V1_0",
    "status"=> "active",
    "url"=> "https://example1.com/",
    "enabled_events" => ['$create_order'],
    "name"=> "My webhook name",
    "description"=> "This is a webhook!"]);
$response->isOk()

Retrieves a webhook when given an ID.

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->retrieveWebhook('webhook_id');
$response->isOk()

List All Webhooks

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->listAllWebhooks();
$response->isOk()

Update a Webhook

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->updateWebhook('webhook_id', ["payload_type" => "ORDER_V1_0",
    "status"=> "active",
    "url"=> "https://example1.com/",
    "enabled_events" => ['$create_order'],
    "name"=> "My webhook name update",
    "description"=> "This is a webhook! update"]);
$response->isOk()

Deletes a webhook when given an ID.

$sift = new SiftClient(['api_key' => 'my_api_key', 'account_id' => 'my_account_id']);
$response = $sift->deleteWebhook('webhook_id');
$response->isOk()

Contributing

Run the tests from the project root with PHPUnit like this:, _(*9)

composer update
composer exec phpunit -v -- --bootstrap vendor/autoload.php test

Updating Packagist

Update composer.json to reflect the new version, as well as any new requirements then merge changes into master., _(*10)
Create a new release with the version number and use it as the description. Packagist will automatically deploy a new package via the configured webhook., _(*11)

HTTP connection pooling

You can substantially improve the performance of SiftClient by using HTTP connection pooling. Because standard PHP/fastcgi deployments don't have a mechanism for persisting connections between requests, the easiest way to pool connections is by routing requests through a proxy like Apache httpd or nginx., _(*12)

Apache httpd, _(*13)

Listen 8081

...

LoadModule proxy_module .../mod_proxy.so
LoadModule proxy_http_module .../mod_proxy_http.so
LoadModule ssl_module .../mod_ssl.so

<VirtualHost localhost:8081>
    ServerName api.sift.com
    SSLProxyEngine on
    SSLProxyVerify require
    SSLProxyVerifyDepth 3
    SSLProxyCACertificateFile ...
    ProxyPass / https://api.sift.com/
</VirtualHost>

nginx, _(*14)

# Read more about nginx keepalive: https://www.nginx.com/blog/tuning-nginx/#keepalive
upstream sift {
    server api.sift.com:443;
    keepalive 16;
}

server {
    listen localhost:8081;
    server_name api.sift.com;

    location / {
        proxy_pass https://sift;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_ssl_verify on;
        proxy_ssl_verify_depth 3;
        proxy_ssl_trusted_certificate ...;
        proxy_ssl_name api.sift.com;
        proxy_ssl_server_name on;
    }
}

For Debian-based distributions, the certificate file is /etc/ssl/certs/ca-certificates.crt, _(*15)

Then, instantiate SiftClient to route requests through the proxy:, _(*16)

$sift = new SiftClient([
    'api_key' => 'my_api_key',
    'account_id' => 'my_account_id',
    'api_endpoint' => 'http://api.sift.com',
    'curl_opts' => [CURLOPT_CONNECT_TO => ['api.sift.com:80:localhost:8081']],
]);

Integration testing app

For testing the app with real calls it is possible to run the integration testing app, it makes calls to almost all our public endpoints to make sure the library integrates well. At the moment, the app is run on every merge to master, _(*17)

How to run it locally

Add env variable ACCOUNT_ID with the valid account id
Add env variable API_KEY with the valid Api Key associated from the account
Run the following under the project root folder

# install the lib from the local source code
composer install -n
# run the app
php test_integration_app/main.php

License

MIT, _(*18)

The Versions

20/07 2018

dev-master

9999999-dev https://github.com/SiftScience/sift-php

Sift Science PHP library

library sift-php

Sift Science PHP library

siftscience/sift-php

The README.md

Sift Bindings

Installation

With Composer

Manually

Usage

Track an event

Label a user as good/bad

Unlabel a user

Get a user's score

Get the status of a workflow run

Get the latest decisions for a user

Get the latest decisions for an order

Get the latest decisions for a session

List of configured Decisions

Apply decision to a user

Apply decision to an order

Apply decision to a session

Creates a new webhook with a specified URL.

Retrieves a webhook when given an ID.

List All Webhooks

Update a Webhook

Deletes a webhook when given an ID.

Contributing

Updating Packagist

HTTP connection pooling

Integration testing app

How to run it locally

License

The Versions

dev-master

The Requires

The Development Requires

by Yoav Schatzberg

by Alex Lopatin

by Jacob Burnim

by Gary Lee

by Mohammed Jouahri

dev-rlong-wf

The Requires

The Development Requires

by Yoav Schatzberg

by Alex Lopatin

by Jacob Burnim

by Gary Lee

by Mohammed Jouahri

dev-mlegore_get_session_decisions

The Requires

The Development Requires

by Yoav Schatzberg

by Alex Lopatin

by Jacob Burnim

by Gary Lee

by Mohammed Jouahri

3.0.1

The Requires

The Development Requires

by Yoav Schatzberg

by Alex Lopatin

by Jacob Burnim

by Gary Lee

by Mohammed Jouahri

dev-kkarpierz_fix_docs

The Requires

The Development Requires

by Yoav Schatzberg

by Alex Lopatin

by Jacob Burnim

by Gary Lee

by Mohammed Jouahri

3.0.0

The Requires

The Development Requires

by Yoav Schatzberg

by Alex Lopatin

by Jacob Burnim

by Gary Lee