Online-Marketing-Api-Toolkit

Was?

Diese Libary bietet eine schnelle Möglichkeit, verschiedene APIs aus dem Online-Marketing-Bereich abzufragen., _(*2)

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., _(*3)

Welche?

Aktuell sind folgende APIs in dieser Library implementiert: * Sistrix * Moz * OmData * Semrush * SEOkicks * Strucr, _(*4)

Installation

Das Online-Marketing-Api-Toolkit ist über Packagist (zedwoo/online-marketing-api-toolkit) erhältlich und damit über Composer installierbar., _(*5)

Composer installieren (bei Bedarf)

Wenn Composer bisher nicht benutzt wurde und nicht installiert wurde, dann einfach installieren:, _(*6)

 curl -sS https://getcomposer.org/installer | php

Weitere Möglichkeiten der Installation sind hier beschrieben: https://getcomposer.org/download/, _(*7)

Wenn Composer nicht benutzt werden soll, dann den Code einfach von Github downloaden und mit einem PSR-0 kompatiblen Autoaloader laden., _(*8)

Neues Projekt erstellen

Du kannst dir ein neues Projekt anlegen, in dem du folgende Zeile ausführst:, _(*9)

php composer.phar create-project zedwoo/online-marketing-api-toolkit projekt_name

Dabei einfach "projekt_name" durch einen eigenen Namen ersetzen., _(*10)

Oder einfacher:, _(*11)

Composer Beispiel für bestehendes Projekt

OnlineMarketingApiToolkit in composer.json hinzufügen bzw. Datei erstellen:, _(*12)

{
    "require": {
        "zedwoo/online-marketing-api-toolkit": "1.*"
    }
}

Und dann folgendes Zeile ausführen:, _(*13)

php composer.phar install

Nutzung

Die Nutzung der unterschiedlichen Clients ist immer ähnlich. Beispiel Sistrix:, _(*14)

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?"., _(*15)

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