Pāriet uz saturu
ShopentlyLearn

Akcijas · Iegūt

Akcijas · Iegūt. Katram kodam jāatļauj apvienošana. Atlaides piemēro secīgi.

GET/api/v1/discounts/promotions/{identity}

Autentifikācija
Bearer
Pieejams no
STANDARD
Nepieciešamās atļaujas
discounts.promotions:read

Koda piemēri

Pieprasījuma piemērs

cURL

: "${SHOPENTLY_SHOP_URL:?}"

curl --disable --globoff --fail-with-body --silent --show-error \
  --proto '=https' --connect-timeout 5 --max-time 30 \
  --request GET \
  --header "Authorization: Bearer ${SHOPENTLY_ACCESS_TOKEN:?}" \
  --url "${SHOPENTLY_SHOP_URL%/}"/api/v1/discounts/promotions/example-campaign

PHP

<?php
declare(strict_types=1);

$baseUrl = rtrim(getenv('SHOPENTLY_SHOP_URL') ?: '', '/');
$origin = parse_url($baseUrl);
if (!$origin || ($origin['scheme'] ?? '') !== 'https' || empty($origin['host']) ||
    isset($origin['user'], $origin['pass']) || isset($origin['user']) || isset($origin['path']) ||
    isset($origin['query']) || isset($origin['fragment'])) {
    throw new RuntimeException('SHOPENTLY_SHOP_URL must be an HTTPS origin');
}
$credential = getenv('SHOPENTLY_ACCESS_TOKEN') ?: '';
if ($credential === '' || strpbrk($credential, "\r\n") !== false) {
    throw new RuntimeException('Invalid credential');
}
$headers = [];
$headers[] = 'Authorization: Bearer ' . $credential;
$responseHeaders = [];
$handle = curl_init($baseUrl . '/api/v1/discounts/promotions/example-campaign');
curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_PROTOCOLS => CURLPROTO_HTTPS,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_SSL_VERIFYHOST => 2,
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HEADERFUNCTION => static function ($handle, string $line) use (&$responseHeaders): int {
        if (str_contains($line, ':')) {
            [$name, $value] = explode(':', $line, 2);
            $responseHeaders[strtolower(trim($name))] = trim($value);
        }
        return strlen($line);
    },
]);
$raw = curl_exec($handle);
$status = curl_getinfo($handle, CURLINFO_RESPONSE_CODE);
$error = curl_error($handle);
curl_close($handle);
if ($raw === false) {
    throw new RuntimeException('Transport error: ' . $error);
}
if ($status < 200 || $status >= 300) {
    throw new RuntimeException('HTTP ' . $status . '; request_id=' .
        ($responseHeaders['x-request-id'] ?? '') . '; retry_after=' . ($responseHeaders['retry-after'] ?? ''));
}
$result = $raw === '' ? null : json_decode($raw, true, 512, JSON_THROW_ON_ERROR | JSON_BIGINT_AS_STRING);
echo json_encode($result, JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE), PHP_EOL;

Python

from contextlib import ExitStack
import json
import os
from urllib.parse import urlsplit

import requests  # python -m pip install requests

base_url = os.environ["SHOPENTLY_SHOP_URL"].rstrip("/")
origin = urlsplit(base_url)
if origin.scheme != "https" or not origin.hostname or origin.username or origin.password or origin.path or origin.query or origin.fragment:
    raise ValueError("SHOPENTLY_SHOP_URL must be an HTTPS origin")
credential = os.environ['SHOPENTLY_ACCESS_TOKEN']
if not credential or "\r" in credential or "\n" in credential:
    raise ValueError("Invalid credential")
headers = {}
headers["Authorization"] = 'Bearer' + " " + credential
body = None
if body is not None:
    headers["Content-Type"] = "application/json"

with ExitStack() as stack:
    session = stack.enter_context(requests.Session())
    files = None
    if False:
        image = stack.enter_context(open(os.environ["SHOPENTLY_IMAGE_FILE"], "rb"))
        if os.fstat(image.fileno()).st_size > 5242880:
            raise ValueError("Image exceeds 5 MiB")
        files = {"file": ("article.png", image, "image/png")}
    response = session.request(
        'GET', base_url + '/api/v1/discounts/promotions/example-campaign', headers=headers,
        data=body.encode("utf-8") if body is not None else None, files=files,
        timeout=(5, 30), allow_redirects=False,
    )
    if not 200 <= response.status_code < 300:
        raise RuntimeError(f"HTTP {response.status_code}; request_id={response.headers.get('X-Request-ID', '')}; retry_after={response.headers.get('Retry-After', '')}")
    if False:
        if response.headers.get("Content-Type") != "image/webp" or len(response.content) > 5242880:
            raise ValueError("Unexpected image response")
        with open(os.environ["SHOPENTLY_OUTPUT_FILE"], "xb") as output:
            output.write(response.content)
    else:
        result = response.json() if response.content else None
        print(json.dumps(result, ensure_ascii=False, indent=2))

Atbildes piemērs 200

JSON
{
  "data": {
    "created_at": "2026-10-07T10:00:00Z",
    "created_by": {
      "kind": "admin",
      "label": "Editorial integration",
      "reference": "learn-api-key"
    },
    "enabled": false,
    "id": "example-campaign",
    "kind": "coupon",
    "markets": [
      {
        "currency": "PLN",
        "market_id": "poland",
        "minor_units": 0
      }
    ],
    "name": "Autumn guide offer",
    "updated_at": "2026-10-07T10:00:00Z",
    "used_count": 0,
    "version": 1
  },
  "meta": {
    "locale": "example",
    "market_code": "example",
    "market_id": "poland",
    "pagination": {
      "has_more": false,
      "limit": 1,
      "next_cursor": null
    },
    "request_id": "learn-example-request"
  }
}

Pārskats

Izvēlētās preces un kategorijas tiek apvienotas. Kategorijas ietver tieši piešķirtās preces.

Parametri

Ceļa parametri

identityVirkneObligāts

Šī resursa ceļā izmantotais identifikators.

Ierobežojumi
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Piemērs: "example-campaign"

Šī darbība nepieņem JSON saturu.

Atbildes

Atbilde 200

dataCampaignData Obligāts

Veiksmīgas atbildes dati.

Lauki · data
audienceVirkneNeobligāts

Klienti

Ierobežojumi
enum
["all", "guest", "customer", "selected"]

Noklusējums: "all"

benefit_typeVirkneNeobligāts

Datu struktūras variants, kuru apraksta atļautās vērtības.

Ierobežojumi
enum
["percentage", "fixed", "none"]

Noklusējums: "percentage"

category_idsMasīvs <Virkne> Neobligāts

Saistīto kategoriju identifikatori.

maxItems: 1000
Ierobežojumi · Masīvs 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
codeVirkne nullNeobligāts

Stabils mašīnlasāms kods.

Ierobežojumi · Virkne 1
pattern
"^[A-Za-z0-9]{6,16}$"
combine_couponsLoģiska vērtībaNeobligāts

Apvienot ar citiem kodiem

Noklusējums: false

combine_promotionsLoģiska vērtībaNeobligāts

Atļaut šo kodu produktiem ar automātiskām akcijām

Noklusējums: false

created_atVirkneObligāts

Izveides laiks.

format: "date-time"
created_byCreatorData Obligāts

Izveidoja

Lauki · created_by
kindVirkneObligāts

Datu struktūras variants, kuru apraksta atļautās vērtības.

Ierobežojumi
enum
["admin", "api"]
labelVirkneObligāts

Resursa nosaukums attiecīgajā kontekstā.

referenceVirkneObligāts

Norādītās entītijas identifikators.

customer_idsMasīvs <Virkne> Neobligāts

Šim resursam saglabātā klienta informācija.

maxItems: 1000
Ierobežojumi · Masīvs 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
enabledLoģiska vērtībaObligāts

Vai šis iestatījums ir ieslēgts.

ends_atVirkne nullNeobligāts

Aktīvs līdz

Virkne:format: "date-time"
free_shippingLoģiska vērtībaNeobligāts

Bezmaksas piegāde

Noklusējums: false

idVirkneObligāts

Resursa identifikators; saglabājiet to atgrieztajā formā.

kindVirkneObligāts

Datu struktūras variants, kuru apraksta atļautās vērtības.

Ierobežojumi
enum
["coupon", "promotion"]
minimum_quantityVesels skaitlisNeobligāts

Minimālais preču skaits grozā

minimum: 1maximum: 2147483647

Noklusējums: 1

nameVirkneObligāts

Resursa nosaukums attiecīgajā kontekstā.

minLength: 1maxLength: 160
per_customer_limitVesels skaitlisNeobligāts

Izmantošanas reižu limits vienam klientam

minimum: -1maximum: 2147483647

Noklusējums: -1

percentageVirkneNeobligāts

Procentuāla

maxLength: 19
Ierobežojumi
pattern
"^(0|[1-9][0-9]{0,13})(\\.[0-9]{1,4})?$"

Noklusējums: "10"

product_idsMasīvs <Virkne> Neobligāts

Saistīto produktu identifikatori.

maxItems: 1000
Ierobežojumi · Masīvs 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
product_scopeVirkneNeobligāts

Produkti

Ierobežojumi
enum
["all", "selected"]

Noklusējums: "all"

show_accountLoģiska vērtībaNeobligāts

Klienta kontā

Noklusējums: false

show_cartLoģiska vērtībaNeobligāts

Grozā

Noklusējums: false

show_productLoģiska vērtībaNeobligāts

Produktu lapās

Noklusējums: false

starts_atVirkne nullNeobligāts

Aktīvs no

Virkne:format: "date-time"
updated_atVirkneObligāts

Pēdējās atjaunināšanas laiks.

format: "date-time"
usage_limitVesels skaitlisNeobligāts

Izmantošanas reižu limits

minimum: -1maximum: 2147483647

Noklusējums: -1

used_countVesels skaitlisObligāts

Izmantošanas reižu skaits

versionVesels skaitlisObligāts

Resursa versija vienlaicīgu izmaiņu kontrolei.

metaContextPageMeta ContextMeta PageMeta RequestMeta Obligāts

Atbildes metadati.

Lauki · meta

ContextPageMeta

localeVirkneObligāts

Šim pieprasījumam izvēlētā valoda.

market_codeVirkneObligāts

Konteksta galapunkta atgrieztais tirgus kods.

market_idVirkneObligāts

Konteksta galapunkta atgrieztais tirgus identifikators.

paginationPagination Obligāts

Kursora lapošanas metadati.

request_idVirkneObligāts

Pieteikuma identifikators; atbildes metadatos tas identificē HTTP pieprasījumu.

minLength: 1maxLength: 100

ContextMeta

localeVirkneObligāts

Šim pieprasījumam izvēlētā valoda.

market_codeVirkneObligāts

Konteksta galapunkta atgrieztais tirgus kods.

market_idVirkneObligāts

Konteksta galapunkta atgrieztais tirgus identifikators.

request_idVirkneObligāts

Pieteikuma identifikators; atbildes metadatos tas identificē HTTP pieprasījumu.

minLength: 1maxLength: 100

PageMeta

paginationPagination Obligāts

Kursora lapošanas metadati.

request_idVirkneObligāts

Pieteikuma identifikators; atbildes metadatos tas identificē HTTP pieprasījumu.

minLength: 1maxLength: 100

RequestMeta

request_idVirkneObligāts

Pieteikuma identifikators; atbildes metadatos tas identificē HTTP pieprasījumu.

minLength: 1maxLength: 100
Atbildes piemērs

HTTP statuss

200
Veiksmīga atbilde Shēma
400
Nederīgs pieprasījums
401
Nepieciešama autentifikācija
403
Piekļuve liegta
404
Resurss nav atrasts
409
Versiju konflikts
422
Validācijas kļūda
429
Pārsniegts pieprasījumu limits
Citi HTTP statusi (7)
405
Metode nav atļauta
413
Pieprasījums ir pārāk liels
415
Neatbalstīts formāts
500
Servera kļūda
502
API vārtejas kļūda
503
Pakalpojums nav pieejams
504
Noildze

Kļūdu katalogs: ErrorResponse

Galvenes

401

WWW-AuthenticateVirkneNeobligāts

Servera pieprasītā autentifikācijas shēma.

405

AllowVirkneNeobligāts

Šī resursa atbalstītās HTTP metodes.

429, 503

Retry-AfterVesels skaitlisNeobligāts

Minimālā aizkave pirms atkārtošanas sekundēs.

minimum: 0