Pređi na sadržaj
ShopentlyLearn

Prikaži listu · Članci

Čitanje članaka i pregled nacrta

GET/api/v1/addons/shopently.blog/posts

Autentifikacija
Bearer
Dostupno od
BASIC
Potreban instalirani modul
shopently.blog · Verzija ugovora modula 1
Potrebna ovlašćenja
addon.shopently.blog:post_read

Primeri koda

Primer zahteva

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/addons/shopently.blog/posts?limit=10&locale=pl&status=draft'

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/addons/shopently.blog/posts?limit=10&locale=pl&status=draft');
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/addons/shopently.blog/posts?limit=10&locale=pl&status=draft', 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))

Primer odgovora 200

JSON
{
  "data": [
    {
      "author_name": "Store editorial team",
      "cover_alt": "Niebieska ilustracja poradnika",
      "cover_media_id": "e8663afe-3c38-461c-a142-a980085630af",
      "first_published_at": null,
      "id": "2103ba96-2713-420b-b197-8a008730c851",
      "public_number": 1,
      "publish_at": null,
      "status": "draft",
      "title": "Jak wybrać produkt",
      "updated_at": "2026-10-07T23:17:44.320869Z",
      "version": 1
    }
  ],
  "meta": {
    "pagination": {
      "has_more": false,
      "limit": 10,
      "next_cursor": null
    },
    "request_id": "56b810d9-7dfa-4bc5-8928-0af90d80dbda"
  }
}

Pregled

Vodite blog prodavnice sa HTML člancima, fotografijama, autorima i metapodacima za pretraživače. Čuvajte nacrte, pripremajte prevode i objavljujte odmah ili u izabrano vreme u određenoj vremenskoj zoni. Upravljajte komentarima i moderiranjem u panelu; spoljni generator može da koristi API sa dodeljenim dozvolama.

BASIC · api.enabled · addons.use(shopently.blog) · addon.shopently.blog:post_read

Parametri

Parametri upita

localeNiz znakovaObavezno

Jezik odabran za ovaj zahtev.

minLength: 2maxLength: 35
Ograničenja
pattern
"^[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,8})*$"
Primer: "pl"
limitCeli brojOpciono

Najveći broj zapisa na ovoj stranici.

minimum: 1maximum: 100
Podrazumevano: 50Primer: 10
cursorNiz znakova nullOpciono

Neprozirna vrednost za nastavak koju je vratila prethodna stranica.

Niz znakova:maxLength: 512
statusNiz znakova nullOpciono

Status prihvaćen za ovu određenu operaciju.

Ograničenja · Niz znakova 1
enum
["draft", "scheduled", "published", "archived"]
Primer: "draft"
titleNiz znakova nullOpciono

Naslov na odabranom jeziku.

Niz znakova:maxLength: 200
author_idNiz znakova nullOpciono

Autor

Niz znakova:format: "uuid"
publish_fromNiz znakova nullOpciono

Objavljeno od

Niz znakova:format: "date-time"
publish_toNiz znakova nullOpciono

Objavljeno pre

Niz znakova:format: "date-time"

Ova operacija ne prihvata JSON telo.

Odgovori

Odgovor 200

dataNiz vrednosti <ObjekatDodatna polja: Ne> Obavezno

Podaci uspešnog odgovora.

maxItems: 100
Polja · data

ObjekatDodatna polja: Ne

author_nameNiz znakovaObavezno

Autor

maxLength: 160
cover_altNiz znakovaObavezno

Alternativni tekst

maxLength: 250
cover_media_idNiz znakova nullObavezno

Naslovna fotografija

Niz znakova:format: "uuid"
first_published_atNiz znakova nullObavezno

Prvi put objavljeno

Niz znakova:format: "date-time"
idNiz znakovaObavezno

Identifikator resursa; sačuvajte ga u vraćenom obliku.

format: "uuid"
public_numberCeli brojObavezno

Broj

minimum: 1
publish_atNiz znakova nullObavezno

Datum objavljivanja

Niz znakova:format: "date-time"
statusNiz znakovaObavezno

Status prihvaćen za ovu određenu operaciju.

Ograničenja
enum
["draft", "scheduled", "published", "archived"]
titleNiz znakovaObavezno

Naslov na odabranom jeziku.

maxLength: 200
updated_atNiz znakovaObavezno

Vreme poslednjeg ažuriranja.

format: "date-time"
versionCeli brojObavezno

Verzija resursa za kontrolu istovremenih upisa.

minimum: 1maximum: 9223372036854775807
metaObjekatDodatna polja: NeObavezno

Metapodaci odgovora.

Polja · meta
paginationObjekatDodatna polja: NeObavezno

Metapodaci paginacije pomoću kursora.

Polja · pagination
has_moreLogička vrednostObavezno

Da li postoji sledeća stranica.

limitCeli brojObavezno

Najveći broj zapisa na ovoj stranici.

minimum: 1maximum: 100
next_cursorNiz znakova nullObavezno

Vrednost za nastavak na sledeću stranicu ili null.

Niz znakova:maxLength: 512
request_idNiz znakovaObavezno

Identifikator zahteva; u metapodacima odgovora označava HTTP zahtev.

minLength: 1maxLength: 100
Primer odgovora

HTTP status

200
Uspešan odgovor Šema
400
Nevažeći zahtev
401
Potrebna je autentifikacija
403
Pristup odbijen
404
Resurs nije pronađen
409
Sukob verzija
422
Provera nije uspela
429
Prekoračeno ograničenje zahteva
Ostali HTTP statusi (7)
405
Metoda nije dozvoljena
413
Zahtev je prevelik
415
Nepodržan format
500
Greška servera
502
Greška API mrežnog prolaza
503
Usluga nije dostupna
504
Istek vremena

Katalog grešaka: ErrorResponse

Zaglavlja

401

WWW-AuthenticateNiz znakovaOpciono

Šema autentifikacije koju zahteva server.

405

AllowNiz znakovaOpciono

HTTP metode koje ovaj resurs podržava.

429, 503

Retry-AfterCeli brojOpciono

Najkraće čekanje pre ponavljanja, u sekundama.

minimum: 0