library sipht

99designs/sipht

A PHP client for the Sift Science REST API

A PHP client for the Sift Science REST API., _(*1)

Note: Sift Science now offer their own PHP bindings [here][2]., _(*2)

, _(*3)

This client supports the three basic operations exposed by the Sift API: posting events, labelling users and fetching scores., _(*4)

The currently supported API version is v203., _(*5)

Instantiating a client

Interactions with the API occur via Sift\Client. You instantiate a client by passing your API key to its constructor:, _(*6)

$client = new Sift\Client('my-api-key');

The following errors may be thrown by any client request:, _(*7)

• Sift\Exception\BadRequestException: HTTP 40x; the request was rejected by the API, _(*8)

• Sift\Exception\ServerErrorException: HTTP 50x; the API endpoint suffered some internal problem, _(*9)

• Sift\Exception\HttpException: any other exception generated in the course of making the HTTP request (e.g. too many redirects), _(*10)

Posting events

Create instances of Sift\Event, e.g.:, _(*11)

$event = new Sift\Event(array(
    '$type' => Sift\Event::TYPE_TRANSACTION,
    '$user_id' => '1234',
    // ...
));

Alternatively, factory constructors are provided for each event type:, _(*12)

$event = Sift\Event::transactionEvent(array(
    '$user_id' => '1234',
    // ...
));

Then post the event via Sift\Client::postEvent():, _(*13)

$response = $client->postEvent($event);

See https://siftscience.com/docs/references/events-api for more information on posting event data., _(*14)

Labelling users

Create label objects using the factory methods of Sift\Label, e.g.:, _(*15)

// Label a user as fraudulent, optionally specifying reason codes and an explanation:
$reasons = array(Sift\Label::REASON_SPAM);
$label = Sift\Label::bad($reasons, 'User engaged in phishing attack')

// Alternatively, correct a false positive by labelling a user as non-fraudulent:
$good = Sift\Label::good('Mistakenly identified as fraudulent');

Then post the event via Sift\Client::labelUser():, _(*16)

$response = $client->labelUser('some-user-id', $label);

See https://siftscience.com/docs/references/labels-api for more information on labelling users., _(*17)

Fetching scores

Fetch fraud score data for a user via Sift\Client::userScore():, _(*18)

$score = $client->userScore('some-user-id');

This returns an instance of Sift\Score. Note that if no events have been captured for the given user, a Sift\Exception\ScoreException will be thrown., _(*19)

See https://siftscience.com/docs/getting-scores for more information on fetching user fraud scores., _(*20)