API за разработчици

API на Гностичния Лексикон

API-то на Гностичния Лексикон дава свободен, отворен достъп в JSON до нарастващ корпус от гностична и езотерична терминология на английски и български, без API ключ и без регистрация. Създадено е за изследователи, разработчици и всеки, който изгражда инструменти за изучаване на древните традиции на мъдростта.

Съдържание

Основен URL

GET https://pleroma.guide/api/lexicon/public

Удостоверяване

Не е необходимо. API-то е безплатно и отворено. Не се изисква API ключ.

Ограничения

100 заявки на час по IP адрес. Хедъри за ограничение са включени във всеки отговор.

X-RateLimit-Limit: 100

X-RateLimit-Remaining: 99

X-RateLimit-Reset: 1712764800

X-License: CC-BY-SA-4.0

Всеки отговор включва и хедър X-License с SPDX идентификатора CC-BY-SA-4.0, така че външни инструменти могат да разпознаят лиценза, без да парсват тази страница. Той покрива собствения текст на Плерома, не цитатите от трети страни в някои статии.

Крайни точки

GET /api/lexicon/public

Връща пагиниран списък с всички термини от лексикона. Поддържа филтриране по стълб, език и търсене.

Параметри на заявката

Параметър	Тип	По подразбиране	Описание
locale	string	"en"	Език: "en" (английски) или "bg" (български)
pillar	string	-	Филтриране по стълб на знанието (напр. cosmology, alchemy, shadow)
q	string	-	Търсене по име на термин (частично съвпадение, без значение на регистъра)
limit	number	50	Резултати на страница, 1–100. По-голяма стойност се свежда до 100.
offset	number	0	Отместване за пагинация

Примерна заявка

curl

curl "https://pleroma.guide/api/lexicon/public?pillar=cosmology&q=hylic"

Примерен отговор

JSON

{
  "data": [
    {
      "term": "Hylic",
      "slug": "hylic",
      "definition": "In Valentinian Gnostic anthropology, a Hylic is a person whose dominant principle is matter (hylē) — one whose consciousness is entirely identified with the material world, unable to perceive the spiritual dimension or the Logos pattern. The Hylic lives within the Demiurge's system without questioning it.",
      "pillar": "cosmology",
      "tradition": "Gnostic (Valentinian)",
      "etymology": "Greek: ὑλικός (hylikos) — of matter; from ὕλη (hylē) — matter, material, wood",
      "relatedTerms": [
        "archon",
        "demiurge",
        "divine-spark",
        "gnosis",
        "logos",
        "nigredo",
        "npc",
        "pistis",
        "pneumatic",
        "simulation"
      ],
      "url": "https://pleroma.guide/en/lexicon/hylic"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 50,
    "offset": 0,
    "locale": "en",
    "hasMore": false
  },
  "attribution": {
    "source": "Pleroma Guide Lexicon",
    "url": "https://pleroma.guide",
    "license": "CC BY-SA 4.0",
    "licenseUrl": "https://creativecommons.org/licenses/by-sa/4.0/",
    "required": "Attribution required: 'Powered by Pleroma Guide' with a link to https://pleroma.guide, and the licence name (CC BY-SA 4.0) with a link to https://creativecommons.org/licenses/by-sa/4.0/",
    "thirdPartyContent": "Passages quoted from other authors and translators (for example published translations of the Nag Hammadi texts) keep their own copyright and are not covered by this licence."
  }
}

GET /api/lexicon/public/[slug]

Връща единичен термин по неговия слъг, включително пълно съдържание и свързани публикации от блога.

Примерна заявка

curl

curl "https://pleroma.guide/api/lexicon/public/hylic"

Примерен отговор

JSON

{
  "data": {
    "term": "Hylic",
    "slug": "hylic",
    "definition": "In Valentinian Gnostic anthropology, a Hylic is a person whose dominant principle is matter (hylē) — one whose consciousness is entirely identified with the material world, unable to perceive the spiritual dimension or the Logos pattern. The Hylic lives within the Demiurge's system without questioning it.",
    "fullContent": "Definition\nIn Valentinian Gnostic anthropology, a Hylic is a person whose dominant principle is matter (hylē) — one whose consciousness is entirely identified…",
    "pillar": "cosmology",
    "tradition": "Gnostic (Valentinian)",
    "etymology": "Greek: ὑλικός (hylikos) — of matter; from ὕλη (hylē) — matter, material, wood",
    "pronunciation": "HY-lik",
    "termOriginal": "ὑλικός",
    "relatedTerms": [
      "archon",
      "demiurge",
      "divine-spark"
    ],
    "relatedPosts": [
      {
        "title": "AI and Gnosticism: Is the Machine a New Demiurge — or a Better Mirror?",
        "slug": "ai-and-gnosticism-machine-as-demiurge",
        "url": "https://pleroma.guide/en/blog/ai-and-gnosticism-machine-as-demiurge"
      }
    ],
    "url": "https://pleroma.guide/en/lexicon/hylic"
  },
  "attribution": {
    "source": "Pleroma Guide Lexicon",
    "url": "https://pleroma.guide",
    "license": "CC BY-SA 4.0",
    "licenseUrl": "https://creativecommons.org/licenses/by-sa/4.0/",
    "required": "Attribution required: 'Powered by Pleroma Guide' with a link to https://pleroma.guide, and the licence name (CC BY-SA 4.0) with a link to https://creativecommons.org/licenses/by-sa/4.0/",
    "thirdPartyContent": "Passages quoted from other authors and translators (for example published translations of the Nag Hammadi texts) keep their own copyright and are not covered by this licence."
  }
}

fullContent, relatedTerms и relatedPosts са съкратени тук; API-то ги връща изцяло.

Полета в отговора

Всеки отговор е JSON обект с три ключа на най-горно ниво: data (терминът или масив от термини), meta (пагинация и метаданни за заявката, само за списъчната крайна точка) и attribution (лиценз и приписване). Таблиците по-долу описват всяко поле, което API-то може да върне.

data — обект на термин

Поле	Тип	Описание
term	string	Каноничното име на термина, както се среща в лексикона.
slug	string	Идентификатор, подходящ за URL. Използвай го в пътя на крайната точка за единичен термин.
definition	string	Краткото определение на статията: абзацът под заглавието „Определение“, в чист текст (обикновено 35–70 думи). Статия без такова заглавие връща първия си абзац.
pillar	string	Стълбът на знанието, към който принадлежи терминът (напр. cosmology, alchemy, shadow).
tradition	string	Традицията или линията, от която произхожда терминът (напр. гностична, херметична, кабалистична).
etymology	string \| null	Произходът на думата, обикновено включва езика източник. Може да е null, ако е неизвестен.
relatedTerms	string[]	Слъгове на други термини, свързани с този. Полезно за обхождане на графа и за секции с близки термини.
url	string	Каноничен URL на страницата на термина в Плерома.
fullContent	string	Цялата статия в чист текст: заглавия и абзаци без Markdown, връзки и компоненти. Само за крайната точка за единичен термин.
pronunciation	string \| null	Приблизително фонетично произношение. Може да е null. Само за крайната точка за единичен термин.
termOriginal	string \| null	Оригиналната форма на термина (напр. на гръцки, иврит), когато е приложимо. Може да е null. Само за крайната точка за единичен термин.
relatedPosts	object[]	Масив от публикации, които се позовават на този термин, всяка с title, slug и url. Само за крайната точка за единичен термин.

meta — само за списъчната крайна точка

Поле	Тип	Описание
meta.total	number	Общ брой термини, които съответстват на текущия филтър, преди пагинация.
meta.limit	number	Размерът на страницата, който реално е приложен (1–100).
meta.offset	number	Отместването, което реално е приложено (след ограничаване).
meta.locale	string	Езикът, използван за този отговор (en или bg).
meta.hasMore	boolean	Вярно, когато има още страници след тази. Еквивалентно на (offset + limit) < total.
meta.warnings	string[] (optional)	Присъства само когато API-то е коригирало входа ти: limit над максимума е сведен до него, limit под 1 е заменен със стойността по подразбиране (50) или отрицателен offset е станал 0. Всеки низ обяснява по една корекция.

attribution

Поле	Тип	Описание
attribution.source	string	Четимо за хора име на източника на данните.
attribution.url	string	URL, към който трябва да сочи препратката при приписване на данните.
attribution.license	string	Името на лиценза, винаги „CC BY-SA 4.0“. Хедърът X-License носи SPDX идентификатора CC-BY-SA-4.0.
attribution.licenseUrl	string	Връзка към текста на лиценза. CC BY-SA 4.0 изисква да я включиш, когато преизползваш данните.
attribution.required	string	Приписването, което молим да показваш до преизползваното съдържание: реда с източника и връзка към него, и лиценза с неговата връзка.
attribution.thirdPartyContent	string	Пасажите, цитирани от други автори и преводачи, запазват своите авторски права; лицензът не ги покрива.

Полета, отбелязани със "само за крайната точка за единичен термин", се появяват при GET /api/lexicon/public/[slug] и са пропуснати в списъчната крайна точка, за да останат отговорите компактни.

Налични стълбове

Използвай тези стойности с параметъра pillar за филтриране на термини по област на знанието.

cosmology
alchemy
frequency
temple
matrix
shadow
astrology
mastery
sophia

Вгради уиджет

Два живи уиджета, които можеш да поставиш на всяка страница. Всеки е самостоятелна рамка: тъмна тема, под 320 px височина, без бисквитки, без аналитика. Постави кода там, където уиджетът трябва да се появи.

Лунно четене на живо — фаза, осветеност, лунен знак, лунна обител, следваща фаза

HTML

<iframe
  src="https://pleroma.guide/bg/embed/moon"
  width="100%"
  height="320"
  loading="lazy"
  title="Лунно четене на живо — Pleroma"
  style="border: 0;max-width: 100%;color-scheme:dark"
></iframe>

Лунен пост — следващият прозорец на свещената секреция за даден слънчев знак

HTML

<iframe
  src="https://pleroma.guide/bg/embed/chrism-fast?sign=capricorn"
  width="100%"
  height="320"
  loading="lazy"
  title="Следващ прозорец за лунен пост — Pleroma"
  style="border: 0;max-width: 100%;color-scheme:dark"
></iframe>

Замени capricorn със слънчевия знак на посетителя (aries … pisces) или премахни параметъра ?sign=, за да покажеш избор от 12 знака.

Атрибуция: запази връзката „С подкрепата на Pleroma“ в уиджета видима и проследима — това е единственото условие за използване.

Изтегли набора от данни на Лексикона

Пълният лексикон — 269 термина на език — като JSON и CSV, обновяван при всяко публикуване.

Полета: term, slug, url, locale, pillar, pillar_label, definition (чист текст), etymology, tradition, related (slugs), term_original, pronunciation, date_added, last_updated, license, generated_at.

Генериран на 2 ноември 2026 г. · Лиценз: CC BY-SA 4.0 — споделяй и адаптирай с атрибуция към Stefan's Alkimia / Pleroma Guide, под същия лиценз.

Цитирай

Готови за копиране референции за набора от данни и за сайта. Кликни върху цитат, за да го избереш.

Набор от данни

APA (7-мо изд.)

Stefan's Alkimia. (2026). Pleroma Guide Lexicon (Version 2026-11-02) [Data set]. Pleroma Guide. https://pleroma.guide/bg/api-docs

Chicago (17-то изд.)

Stefan's Alkimia. 2026. Pleroma Guide Lexicon. Version 2026-11-02, dataset. Pleroma Guide. https://pleroma.guide/bg/api-docs.

Уебсайт

APA (7-мо изд.)

Stefan's Alkimia. (2026). Pleroma — The Fullness of Hidden Knowledge. Pleroma Guide. https://pleroma.guide/

Chicago (17-то изд.)

Stefan's Alkimia. 2026. Pleroma — The Fullness of Hidden Knowledge. Pleroma Guide. Accessed November 2, 2026. https://pleroma.guide/.

Приписване

Данните са под лиценз CC BY-SA 4.0. Използвай ги във всеки проект, с приписване, което сочи към Плерома и назовава лиценза.

HTML

<a href="https://pleroma.guide">Powered by Pleroma Guide</a> · <a href="https://creativecommons.org/licenses/by-sa/4.0/">CC BY-SA 4.0</a>

Лиценз

Creative Commons Признание-Споделяне на споделеното 4.0 Международен (CC BY-SA 4.0). Можеш да споделяш и адаптираш данните за всякакви цели, включително търговски, стига да посочиш източника и да разпространяваш производните произведения под същия лиценз. Лицензът покрива само собствения текст на Плерома. Пасажи, цитирани от други автори и преводачи, например публикувани преводи на текстовете от Наг Хамади, запазват своите авторски права и не са лицензирани тук.

Кодове за грешки

Код	Значение
200	Успех
400	Невалидна заявка: невалиден език, непознат стълб, q по-дълго от 200 знака или невалиден слъг
404	Терминът не е намерен (само за единичен термин)
429	Ограничението е надвишено. Провери хедъра Retry-After.

Обратна връзка и контакт

Откри бъг, грешна дефиниция или ти трябва по-високо ограничение за изследване или по-голяма интеграция? Пиши директно — всяко съобщение се чете от човек.

pleroma@pleroma.guide

Увеличения на лимита се одобряват за всеки случай поотделно. Включи кратко описание на проекта и очаквания обем заявки и обикновено ще получиш отговор в рамките на няколко дни.