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

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

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

Основен URL

GET https://pleroma.stefansalkimia.com/api/lexicon/public

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

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

Ограничения

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

X-RateLimit-Limit: 100

X-RateLimit-Remaining: 99

X-RateLimit-Reset: 1712764800

Крайни точки

GET /api/lexicon/public

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

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

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

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

curl

curl "https://pleroma.stefansalkimia.com/api/lexicon/public?pillar=cosmology&limit=10"

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

JSON

{
  "data": [
    {
      "term": "Archon",
      "slug": "archon",
      "definition": "A cosmic parasitic entity in Gnostic cosmology...",
      "pillar": "cosmology",
      "tradition": "Gnostic",
      "etymology": "Greek: archon — ruler",
      "relatedTerms": [
        "demiurge",
        "sophia"
      ],
      "url": "https://pleroma.stefansalkimia.com/en/lexicon/archon"
    }
  ],
  "meta": {
    "total": 143,
    "limit": 50,
    "offset": 0,
    "locale": "en"
  },
  "attribution": {
    "source": "Pleroma Gnosis Lexicon",
    "url": "https://pleroma.stefansalkimia.com",
    "license": "CC BY-SA 4.0",
    "required": "Attribution required: 'Powered by Pleroma Gnosis'"
  }
}

GET /api/lexicon/public/[slug]

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

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

curl

curl "https://pleroma.stefansalkimia.com/api/lexicon/public/archon"

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

JSON

{
  "data": {
    "term": "Archon",
    "slug": "archon",
    "definition": "A cosmic parasitic entity in Gnostic cosmology...",
    "fullContent": "A cosmic parasitic entity in Gnostic cosmology that rules the material world...",
    "pillar": "cosmology",
    "tradition": "Gnostic",
    "etymology": "Greek: archon — ruler",
    "pronunciation": "AR-kon",
    "termOriginal": null,
    "relatedTerms": [
      "demiurge",
      "sophia"
    ],
    "relatedPosts": [
      {
        "title": "What Are Archons?",
        "slug": "what-are-archons",
        "url": "https://pleroma.stefansalkimia.com/en/blog/what-are-archons"
      }
    ],
    "url": "https://pleroma.stefansalkimia.com/en/lexicon/archon"
  },
  "attribution": {
    "source": "Pleroma Gnosis Lexicon",
    "url": "https://pleroma.stefansalkimia.com",
    "license": "CC BY-SA 4.0",
    "required": "Attribution required: 'Powered by Pleroma Gnosis'"
  }
}

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

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

cosmology

alchemy

frequency

temple

matrix

shadow

astrology

mastery

sophia

Приписване

Този API е лицензиран под CC BY-SA 4.0. Свободен си да използваш данните във всеки проект, при условие че включиш приписване с връзка към Плерома.

HTML

Powered by Pleroma Gnosis

Лиценз

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

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

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