Автоматизируйте OrbitPage без совместного использования сеанса информационной панели.

Три границы учетных данных охватывают три разные должности.

На этой странице документирована граница версий REST. Токен OrbitPage не является ключом поставщика OpenAI и никогда не проверяет подлинность конечных точек частной информационной панели.

Все поддерживаемые операции панели управления, сгруппированные по поверхности, которую они контролируют.

Пути ниже указаны относительно https://orbitpage.com/api/v1. Метод, путь и область действия представляют собой стабильный контракт интеграции; Схемы запросов, форматы, значения перечислений и модели ответов находятся в связанном документе OpenAPI 3.1. Неизвестные маршруты возвращают 404, а неподдерживаемые методы никогда не преобразуются автоматически.

Создайте один токен для одной автоматизации и одной среды.

Откройте «Панель управления» > «Учетная запись» > «Токены личного API». Дайте токену имя, которое идентифицирует его владельца и назначение, выберите полную рабочую область, рабочую область только для чтения, только ссылки или отдельные области ресурсов, затем выберите срок действия 30, 90 или 365 дней — или не истечение срока действия, если документированный процесс ротации уже существует.

export ORBITPAGE_TOKEN='op_pat_...'

curl --silent --show-error --include \
  --header "Authorization: Bearer $ORBITPAGE_TOKEN" \
  https://orbitpage.com/api/v1/links

$env:ORBITPAGE_TOKEN = 'op_pat_...'
$headers = @{ Authorization = "Bearer $env:ORBITPAGE_TOKEN" }

Invoke-RestMethod -Uri 'https://orbitpage.com/api/v1/links' -Headers $headers

Прочитайте коллекцию и запишите ее версию перед каждым изменением.

Тело ответа содержит упорядоченные блоки данных и текущую числовую версию. Та же редакция появляется в X-OrbitPage-Revision и как слабый ETag. Сохраните любое значение для If-Match; не угадывайте и не кэшируйте его в несвязанных запусках.

HTTP/2 200
etag: W/"42"
x-orbitpage-revision: 42
content-type: application/json; charset=utf-8

{
  "object": "list",
  "data": [
    {
      "id": "portfolio-main",
      "type": "link",
      "title": "Selected work",
      "description": "Recent projects and case studies",
      "url": "https://example.com/work",
      "isActive": true,
      "status": "live",
      "availability": "available",
      "clickCount": 18,
      "position": 0
    }
  ],
  "revision": 42,
  "workspace": {
    "tenantId": "tenant_...",
    "pageId": "page_...",
    "username": "your-page"
  }
}

Используйте PATCH для наименьшего изменения существующего блока.

URL-кодируйте идентификатор, возвращаемый GET, и отправляйте только те поля, которые должны измениться. OrbitPage объединяет исправление с существующим блоком, защищает поля идентификации и аналитики, проверяет всю страницу на соответствие ее схеме и плану, а затем немедленно публикует.

curl --request PATCH \
  --url https://orbitpage.com/api/v1/links/portfolio-main \
  --header "Authorization: Bearer $ORBITPAGE_TOKEN" \
  --header 'Content-Type: application/json' \
  --header 'If-Match: W/"42"' \
  --data '{
    "title": "Book a consultation",
    "url": "https://example.com/book",
    "isActive": true
  }'

Используйте PUT только тогда, когда необходимо изменить саму коллекцию.

PUT заменяет всю упорядоченную коллекцию. Это операция добавления блока, удаления блока или изменения порядка страниц. Это не ярлык для обновления одного заголовка: пропуск блока удаляет его со страницы.

const token = process.env.ORBITPAGE_TOKEN;
if (!token) throw new Error("ORBITPAGE_TOKEN is missing");

const endpoint = "https://orbitpage.com/api/v1/links";
const authorization = { Authorization: `Bearer ${token}` };

const read = await fetch(endpoint, { headers: authorization });
if (!read.ok) throw new Error(`GET failed: ${read.status} ${await read.text()}`);

const current = await read.json();
const revision = read.headers.get("etag") ?? String(current.revision);

// Preserve the full collection and change only the intended block.
const links = current.data.map((block) =>
  block.id === "portfolio-main"
    ? { ...block, title: "Work and case studies" }
    : block
);

const write = await fetch(endpoint, {
  method: "PUT",
  headers: {
    ...authorization,
    "Content-Type": "application/json",
    "If-Match": revision
  },
  body: JSON.stringify({ links })
});

if (!write.ok) throw new Error(`PUT failed: ${write.status} ${await write.text()}`);
console.log(await write.json());

Используйте собственный узел n8n или тот же контракт из HTTP-клиента, сгенерированного клиента, серверной части или средства запуска CI.

OrbitPage не требует SDK: совместим любой HTTPS-клиент, который может отправлять JSON, аутентификацию носителя и стандартные запросы GET, POST, PUT, PATCH и DELETE. Приведенные ниже шаблоны охватывают части с состоянием, которые интеграция должна обрабатывать явно.

Install community node: n8n-nodes-orbitpage

Credential: OrbitPage API
OrbitPage API Token: op_pat_...
OrbitPage Base URL: https://orbitpage.com
Connection test: GET /api/v1/workspace

First safe workflow step:
Node: OrbitPage
Resource: Workspace & Draft
Operation: Get Workspace Overview

First revision-controlled write:
Resource: Theme
Operation: Replace Entire Theme Draft
Revision Check: Use Latest Automatically (Recommended)

# 1. Reserve an upload and receive uploadUrl, slot and uploadToken
POST /api/v1/media/uploads/reserve
{ "filename": "cover.jpg", "contentType": "image/jpeg", "sizeBytes": 245760 }

# 2. Upload the bytes directly using the returned URL, method and headers
# Do not forward the OrbitPage Authorization header to the storage URL.

# 3. Register the uploaded object in the workspace
POST /api/v1/media/uploads/finalize
{ "slot": "<slot>", "uploadToken": "<uploadToken>" }

# 1. Generate a validated preview without changing the page
POST /api/v1/ai/plan
{ "message": "Make the primary CTA clearer" }

# 2. Review the returned operations and previewToken

# 3. Apply the exact reviewed preview; publishing remains explicit
POST /api/v1/ai/commit
{ "previewToken": "<previewToken>", "publish": false }

Прочтите полное руководство по собственному узлу n8n.

Считайте учетные данные автоматизации как короткие, наблюдаемые жизненные циклы.

Рабочая область поддерживает до десяти активных личных токенов на одного пользователя. В списке учетных записей показаны префикс каждого токена, области действия, даты создания и истечения срока действия, а также недавнее использование. Временные метки последнего использования намеренно записываются не чаще одного раза в пять минут.

name: Update OrbitPage
on: workflow_dispatch

jobs:
  update:
    runs-on: ubuntu-latest
    env:
      ORBITPAGE_TOKEN: ${{ secrets.ORBITPAGE_TOKEN }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: node scripts/update-orbitpage.mjs

• Назовите токены по системе и среде, например «Действия GitHub · производство».
• Ротация путем создания замены, обновления секретного хранилища, проверки одного чтения, а затем отзыва старого токена.
• Отозвать немедленно после подозрения на раскрытие информации, смену владельца или прекращение рабочего процесса. Отзыв вступает в силу при следующем запросе.
• Не создавайте долгосрочный общий токен. Отдельные учетные данные делают ведение журналов, ротацию и реагирование на инциденты понятными.

Ветка по статусу HTTP и машиночитаемому коду.

При ошибках используется JSON с ошибкой и кодом. Не анализируйте человеческое предложение для управления рабочим процессом. Большинство ответов 4xx требуют изменения запроса или учетных данных; к автоматическому пути повторной попытки относятся только конфликты ревизий и ограничения скорости.

Текущие ограничения допускают 120 запросов в минуту и ​​5000 запросов в день на один токен. Ограничения могут стать более строгими во время защиты от злоупотреблений; всегда соблюдайте команду Retry-After.

Безопасная интеграция является узкой, секретной и учитывает версии.

REST API автоматизации с персональным токеном — это управляемая возможность SaaS.

В репозитории с открытым исходным кодом есть Express API для встроенной панели, но этот внутренний API сессии администратора не является тем же версионированным контрактом автоматизации. Не отправляйте токен op_pat на self-hosted сервер и не отправляйте JWT self-hosted администратора на orbitpage.com/api/v1.