Pokretanje aplikacije i sadržaj
Kad se vaša prodavnica ili aplikacija pokrene, čita ono što joj treba da se iscrta: tržište, jezik i valutu, tekstove interfejsa, temu i meni. Sadržaj kao što su članci i stranice čita se kad ekranu zatreba. Svaki poziv ovde radi sa bilo kojom sesijom, i sa sesijom gosta.
Pri pokretanju#
- Pokrenite sesiju i sačuvajte njen token; pogledajte Sesije i prijavu. Tržište, jezik i valuta sesije su podrazumevani za vašu aplikaciju, i svaki poziv niže ih koristi osim ako pošaljete druge.
- Učitajte tekstove interfejsa preko
GET /session/translation. - Izaberite temu:
GET /session/ui_themesdaje id-jeve svetle i tamne teme, aGET /session/theme?themeId=podešavanja jedne od njih. - Učitajte navigaciju preko
GET /session/menu, a liste za izbor prekoGET /session/markets,/session/languagesi/session/currencies.
Sve putanje niže su ispod /api/v2 i primaju token sesije u Authorization: Bearer.
Tekstovi interfejsa#
Svi tekstovi vaše aplikacije na jednom jeziku, po ključevima kako ih imenuju vaša aplikacija i Admin. Tekst koji nedostaje na jeziku dolazi iz rezervnog jezika, a kad i tamo nedostaje, vraća se sam ključ, pa ekran uvek ima šta da prikaže.
Parametri upita
| Parametar | Opis |
|---|---|
| languageIdinteger · podrazumevano jezik sesije | Jezik. |
| keystring | Samo jedan tekst. |
Vraća
data: listu key i translation, sa id, app_id i language_id. Ta tri su null kad tekst dolazi iz rezervnog jezika.
curl "https://api.morffeus.com/api/v2/session/translation" \ -H "Authorization: Bearer $SESSION_TOKEN"
{
"data": [
{ "key": "Basket.Title", "translation": "Your basket", "language_id": 1, … },
{ "key": "Checkout.Pay", "translation": "Pay now", "language_id": 1, … }
]
}
Teme#
| Poziv | Vraća |
|---|---|
| GET /session/ui_themes | data.light_ui_theme_id i data.dark_ui_theme_id: podrazumevanu svetlu i tamnu temu aplikacije. Bilo koja može biti null. |
| GET /session/theme | Podešavanja jedne teme kao listu element, value, value_type, category i description. Pošaljite themeId; bez njega, podrazumevana tema aplikacije. Podešavanje koje tema ne postavlja dolazi iz njene rezervne teme. details=true dodaje fallback_value. 404 sa praznim telom kad teme nema. |
Meni#
GET /session/menu vraća podrazumevani meni aplikacije kao stablo, ili drugi meni sa type=. Svaka stavka ima id, translation_key (natpis potražite u tekstovima), screen, icon, ordinal, parent_id, login, mobile_enabled i open_full_screen, sa decom u level_x. Stavke su poređane po ordinal. Nema menija: 404 sa praznim telom.
Tržišta, jezici, valute#
| Poziv | Vraća |
|---|---|
| GET /session/markets | Sva tržišta vaše aplikacije: id, code, name, default, url, timezone, iso_country_code, i prekidače login_enabled, checkout_enabled i maintenance_enabled. |
| GET /session/languages | Jezike tržišta sesije, podrazumevani prvi: id, lang, lang_code, locale, name, short_name, default, image_url. marketId= za drugo vaše tržište, all=true za sva tržišta. |
| GET /session/currencies | Valute tržišta sesije: id, name, sign, iso_code, display_price_format, default. marketId= za drugo tržište. |
Pre nego što ponudite prijavu ili naplatu, proverite maintenance_enabled, login_enabled i checkout_enabled na trenutnom tržištu.
Članci, stranice, verzija#
| Poziv | Vraća |
|---|---|
| GET /session/articles | Članke na jeziku sesije koji su sada objavljeni, poređane po ordinal: id, title, excerpt, content, image_url, video_url, publish_on, publish_until, article_category_id i category_name. Filtrirajte sa articleCategoryId. Članak bez datuma objave se ne vraća. |
| GET /session/mpages | Jednu stranicu napravljenu u Admin-u, sa komponentama po redu: id, name, ordinal, i components, svaka sa component, props i ordinal. Pošaljite id stranice kao pageTypeId i njen name. null kad ništa ne odgovara. |
| GET /session/version | data.version: verziju Morffeus platforme, istu za svaku aplikaciju. |
Povezano#
- Sesije i prijava: token sesije.
- Obaveštenja i saglasnosti: ono čime upravlja prijavljeni kupac.