API endpoint: /plugin/button

Umožňuje vytvoriť tlačidlo (odkaz s URL) v administrácii eshopu na vlastnú akciu. K volaným URL môžu byť pridané parametre v závislosti od povahy tlačidla (napr. zoznam zvolených objednávok)

Možné rozšírenia:

Selector Parametre Popis
admin:orders:export order=1,2,3 Odovzdáva zoznam zvolených objednávok v administrácii.

Vytvorenie tlačidla

POST /plugin/button

 
    {
        "selector": "admin:orders:export",
        "actionUrl": "https://plugin.tdl/action?eshop=_ESHOP_CODE_",
        "label": "Doplněk test",
        "icon": "https://plugin.tld/images/icon.png"
    }
 

Príklad:

 
    $curl = curl_init();
    curl_setopt_array($curl, array(
        CURLOPT_URL => 'https://api.webareal.cz/plugin/button',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => '',
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 0,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => 'POST',
        CURLOPT_POSTFIELDS => json_encode([
            "selector" => "admin:orders:export",
            "actionUrl" => "https://plugin.tdl/action?eshop=_ESHOP_CODE_",
            "label" => "Doplněk test",
            "icon" => "https://plugin.tld/images/icon.png"
        ])
        CURLOPT_HTTPHEADER => array(
            'X-Wa-api-token: ' . $api_token, // apiToken získáte při instalaci doplňku, viz. nápověda
            'Authorization: Bearer ' . $bearer, // access token získáte zde, údaje zde (záložka API přístup)
            'Content-Type: application/json'
      ),
    ));

    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;
 


Odstránenie tlačidla

DELETE /plugin/button/{id}


Príklad:

 
    $curl = curl_init();
    curl_setopt_array($curl, array(
        CURLOPT_URL => 'https://api.webareal.cz/plugin/button/{id}',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => '',
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 0,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => 'DELETE',
        CURLOPT_HTTPHEADER => array(
            'X-Wa-api-token: ' . $api_token, // apiToken získáte při instalaci doplňku, viz. nápověda
            'Authorization: Bearer ' . $bearer, // access token získáte zde, údaje zde (záložka API přístup)
            'Content-Type: application/json'
      ),
    ));

    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;