zedwoo / online-marketing-api-toolkit
Toolkit for requesting online marketing apis
Requires
- php: >=5.3.3
- guzzle/guzzle: >=3.7.0,<=3.9.9
Requires (Dev)
- loco/swizzle: ~1.0
- phpunit/phpunit: 3.7.*
This package is not auto-updated.
Last update: 2024-11-05 03:03:03 UTC
README
##Was? Diese Libary bietet eine schnelle Möglichkeit, verschiedene APIs aus dem Online-Marketing-Bereich abzufragen.
##Warum? Viele Rest-APIs haben keinen Client und bieten nur beispielhaften Code. Diese Library nutzt die Guzzle HTTP Client Library. Dadurch hat man für alle APIs die tollen Möglichkeiten von Guzzle:
- immer gleiches Exceptionhandling
- tolle Module (Bsp.: Backoff-Plugin)
- etc.
##Welche? Aktuell sind folgende APIs in dieser Library implementiert:
##Installation Das Online-Marketing-Api-Toolkit ist über Packagist (zedwoo/online-marketing-api-toolkit) erhältlich und damit über Composer installierbar.
###Composer installieren (bei Bedarf) Wenn Composer bisher nicht benutzt wurde und nicht installiert wurde, dann einfach installieren:
curl -sS https://getcomposer.org/installer | php
Weitere Möglichkeiten der Installation sind hier beschrieben: https://getcomposer.org/download/
Wenn Composer nicht benutzt werden soll, dann den Code einfach von Github downloaden und mit einem PSR-0 kompatiblen Autoaloader laden.
###Neues Projekt erstellen Du kannst dir ein neues Projekt anlegen, in dem du folgende Zeile ausführst:
php composer.phar create-project zedwoo/online-marketing-api-toolkit projekt_name
Dabei einfach "projekt_name" durch einen eigenen Namen ersetzen.
Oder einfacher: ###Composer Beispiel für bestehendes Projekt OnlineMarketingApiToolkit in composer.json hinzufügen bzw. Datei erstellen:
{ "require": { "zedwoo/online-marketing-api-toolkit": "1.*" } }
Und dann folgendes Zeile ausführen:
php composer.phar install
##Nutzung Die Nutzung der unterschiedlichen Clients ist immer ähnlich. Beispiel Sistrix:
require_once('vendor/autoload.php'); // Autoloaderaufruf von Composer use Zedwoo\OnlineMarketingApiToolkit\Sistrix\SistrixClient; $client = SistrixClient::factory(array( 'api_key' => 'SISTRIX_API-Key' )); $command = $client->getCommand('credits'); $result = $command->execute(); // returns an array with the result
Für jede APi gibt es eine kurze Doku und eine Datei im Json-Schema. Siehe die Links unter "Welche?".
##Contributing
Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request