Aktivace doplňku
Request body
token
string
identifikátor e-shop
version
intiger
Identifikátor verze doplňku
apiUser
string
uživatelský přistup do API e-shop
apiKey
string
uživatelské přistupové heslo do API e-shopu
apiUrl
string
API URL eshopu. Není unikátní a může se měnit. Nedoporučujeme používat pro párování uživatele.
current_admin_language
enum
Jazyk administrace podle ISO 639-1
cs
Čeština
string
sk
Slovenština
string
en
Angličtina
string
time
string
Čas platnosti signature_v2 podle ISO 8601
signature_v2
string
base64_encode podpis specifikovaných atributů pomocí privatního klíče
Pro vytvoření budete potřebovat znát signature_token.
Pro vytvoření budete potřebovat znát signature_token.
POST https://vasedomena.com/vášInstalačníAPIEndoint JSON
{
"token": "",
"version": 0,
"apiUser": "",
"apiKey": "",
"apiUrl": "",
"current_admin_language": "cs",
"time": "",
"signature_v2": ""
}
Response body
error
required
boolean
true / false, 1 / 0
message
string
potřebné pokud je error = TRUE.
{} Response JSON
{
"error": false,
"message": ""
}
Podpisový vzor
Co je to podpis a proč se používá se dozvíte zde.
signature_token je speciální identifikátor vašeho doplňku. Najdete jej v Marketplace / Detail doplňku - Vývoj doplňku (více zde)
{} Signature_v2 PHP
<?php
$data = implode(";", [
"token" => "...",
"apiUser" => "...",
"apiKey" => "...",
"apiUrl" => "https://...",
"time" => "...",
"signature_token" => "...",
]);
$signature_v2 = 'a0e0a3e7689bd4c80e4d6ffcccb05235b864e1d0';
$signaturePublicKey = file_get_contents("https://files.upgates.com/addons/signature/api.signature.pub.key");
$verify = openssl_verify($data, base64_decode($signature_v2), $signaturePublicKey, OPENSSL_ALGO_SHA256);
Neúspěšná instalace
- Doplněk nelze aktivovat, pokud:
- Vaše odpověď je delší než 5 vteřin.
- Jakákoliv jiná odpověď než se stavovým kódem HTTP 200.
- Odpověď HTTP 200 není validní.
Odpověď (Validace)
requiredattributerrorTRUE(bool) - Problém na straně doplňku - instalace by proběhla v pořádku, ale zákazník musí před instalací splnit dodatečné podmínky, než bude moct nainstalovat doplněk.FALSE(bool) - Vše proběhlo v pořádku, doplněk je úspěšně nainstalován.
- cURL podporované kódování obsahu
- libcurl
- deflate
- gzip
- br
- zstd
Changelog
| Datum | Typ | Změna |
|---|---|---|
| 01.01.2025 | signature |
signature byl odstraněn a nahrazen novou verzí signature_v2 |
