Install it via composer

composer require dsl/my-target-sdk

How to work with it?

$clients =newClientOperator(...);$client =$clients->create(newAdditionalUserInfo("cl1"));$campaigns =newCampaignOperator(...);$targeting =newCampaignTargeting();$targeting->setAge(range(20,30));$targeting->setSex(Sex::female());$createCampaign =newCreateCampaign("awesome campaign",newPackageId(83),$targeting);$createCampaign->setStatus(Status::active());$createdCampaign =$campaigns->forClient($client->getUsername())->create($createCampaign);

Bootstrap it in 5 minutes

namespacesandbox;useMyTarget\Client;useGuzzleHttp\Psr7\Uri;useGuzzleHttp\ClientasGuzzleClient;useMyTarget\Transport\GuzzleHttpTransport;useMyTarget\Transport\Middleware\HttpMiddlewareStack;useMyTarget\Transport\Middleware\HttpMiddlewareStackPrototype;useMyTarget\Transport\Middleware\Impl\CallbackMiddleware;useMyTarget\Transport\Middleware\Impl\ResponseValidatingMiddleware;useMyTarget\Token\Token;usePsr\Http\Message\RequestInterface;$baseUri =newUri('https://target.my.com');$token =newToken("ACCESS_TOKEN","bearer",new \DateTime(),"");// библиотека также в состоянии управлять набором токенов в любом типе хранилища (а также получать новые и рефрешить)$http =newGuzzleHttpTransport(newGuzzleClient());$httpStack = HttpMiddlewareStackPrototype::newEmpty($http);$httpStack->push(newResponseValidatingMiddleware());// подпишем все запросы заранее полученным токеном (также можно использовать более сложный TokenGrantMiddleware, который способен хранить токен в любых хранилищах, обновлять и получать его)$accessToken ="foo bar";$httpStack->push(newCallbackMiddleware(function (RequestInterface$req,HttpMiddlewareStack$stack,$context =null)use ($accessToken) {$req =$req->withHeader('Authorization',sprintf('Bearer %s',$accessToken));return$stack->request($req,$context);}));$client =newClient(newRequestFactory($baseUri),$httpStack);

$autoloader =require_once__DIR__ .'/../vendor/autoload.php';// когда подключается автолоадер нужно присвоить его переменной (этот код будет в самом начале)AnnotationRegistry::registerLoader([$autoloader,'loadClass']);// нужно для правильной работы doctrine/annotations$mapper =\MyTarget\simpleMapper($debug =true);

$clients =newClientOperator($client,$mapper);var_dump($clients->all());

Advanced features and usage

How does it work?

HttpMiddleware

class MyMiddlewareimplements HttpMiddleware{publicfunctionrequest(RequestInterface$request,HttpMiddlewareStack$stack,array$context =null)    {return$stack->request($request,$context);    }

class LoggingMiddlewareimplements HttpMiddleware{publicfunctionrequest(RequestInterface$request,HttpMiddlewareStack$stack,array$context =null)    {try {$response =$stack->request($request,$context);log($request,$response);return$response;        }catch (RequestException$e) {logError($request,$e);throw$e;        }    }}

Exceptions hierarchy

- MyTarget\Exception\MyTargetException - Интерфейс (маркер) всех исключений этой библиотеки (если есть необходимость "не выпускать" никаких исключений от СДК, то нужно ловить этот тип исключения)  - MyTarget\Transport\Exception\TransportException - thrown during request transferring phase    - MyTarget\Transport\Exception\RequestException      - MyTarget\Transport\Exception\ClientErrorException      - MyTarget\Transport\Exception\ConnectException      - MyTarget\Transport\Exception\ServerErrorException      - MyTarget\Transport\Exception\TooManyRedirectsException      - MyTarget\Token\Exception\TokenRequestException        - MyTarget\Token\Exception\TokenLimitReachedException        - MyTarget\Token\Exception\TokenDeletedException      - MyTarget\Limiting\Exception\ThrottleException - thrown before the request if you've reached the rate limit, or after the response is parsed and it contains a 429 code  - MyTarget\Exception\DecodingException - thrown during response decoding phase

How to contribute