Variabila | Tip | Descriere |
---|---|---|
list_id | int|string | ID-ul listei în care va fi adăugat cuponul |
name | string | Numele cuponului care va fi adăugat |
status | int|string | Status-ul cuponului (1 pentru activ, 0 pentru inactiv) |
type | string | Tipul cuponului. Poate fi import sau api |
type_data | struct|array | Array conținând parametri specifici tipului cuponului. Dacă type este import, atunci cheile permise sunt: notify_drops_below (int, când numărul de coduri scade sub aceasta limită, se va trimite o notificare), notify_drops_email (adrese de email către care să se trimită notificarea de coduri lipsă. Poate fi array sau string - adrese de email separate prin virgulă). Dacă type este api, atunci cheile permise sunt: api_url (url-ul de webhook), api_prefix (prefixul pentru coduri, poate fi gol), discount_type (percent, fixed sau free_shipping), discount_percent (valoarea procentajului de discount dacă tipul discount-ului este percent), discount_fixed (valoarea discountului fix dacă tipul este fixed), minimum_purchase_amount (valoarea comenzii minime pentru care se poate aplica cuponul), regen_min_count_below (când numărul de coduri scade sub această limită, se vor genera coduri noi), regen_codes_count (numărul de coduri care să fie generate când nu mai sunt suficiente coduri), regen_codes_batch_size (câte coduri să fie generate per apel), api_currency (RON sau EUR or empty / null) |
expire | struct|array|boolean|string | Când ar trebui să expire codurile acestui cupon (după import sau generare prin API). Puteți să trimiteți un string gol, sau null, sau false dacă nu expiră codurile. Dacă ar trebui să expire codurile, ar trebui trimis un array având cheile următoare: expire_type (days, hours sau date) șî expire_value (int sau string). Dacă expire_type este days sau hours, expire_value ar trebui să fie numărul de zile sau ore la care expiră codul după generare (int). Dacă expire_type este date, expire_value ar trebui să fie o dată în format YYYY-MM-DD. |
Parametru | Descriere |
---|---|
array | Array conținand informațiile cuponului adăugat |
{ "list_id": "my_list_id", "name": "MYTESTCOUPON", "api": { "api_url": "my_webhook_url", "currency": "RON", "discount_percent": 20, "discount_type": "percent", "minimum_purchase_amount": 150, "prefix": "PRFX", "regen_batch_size": 125, "regen_codes_count": 500, "regen_min_count_below": 100 }, "expire_type": "add", "status": 1, "type": "api", "id": "my_coupon_id" }
Cod | Mesaj | Descriere |
---|---|---|
407 | Missing required param list_id | Parametrul list_id este obligatoriu |
407 | Missing required param name | Parametrul name este obligatoriu |
407 | Missing required param status | Parametrul status este obligatoriu |
407 | Missing required param type | Parametrul type este obligatoriu |
407 | Missing required param type_data | Parametrul type_data este obligatoriu |
407 | Missing required param expire | Parametrul expire este obligatoriu |
{ "err": true, "message": "Missing required param list_id", "code": 407 }
{ "err": true, "message": "Missing required param name", "code": 407 }
{ "err": true, "message": "Missing required param status", "code": 407 }
{ "err": true, "message": "Missing required param type", "code": 407 }
{ "err": true, "message": "Missing required param type_data", "code": 407 }
{ "err": true, "message": "Missing required param expire", "code": 407 }