Zautomatyzuj OrbitPage bez udostępniania sesji panelu kontrolnego.

Trzy granice uprawnień obejmują trzy różne zadania.

Ta strona dokumentuje wersjonowaną granicę REST. Token OrbitPage nie jest kluczem dostawcy OpenAI i nigdy nie uwierzytelnia punktów końcowych prywatnego pulpitu nawigacyjnego.

Każda obsługiwana operacja na pulpicie nawigacyjnym, pogrupowana według kontrolowanej przez nią powierzchni.

Poniższe ścieżki odnoszą się do https://orbitpage.com/api/v1. Metoda, ścieżka i zakres to stabilny kontrakt integracyjny; schematy żądań, formaty, wartości wyliczeniowe i modele odpowiedzi znajdują się w połączonym dokumencie OpenAPI 3.1. Nieznane trasy zwracają 404, a nieobsługiwane metody nigdy nie są konwertowane w trybie dyskretnym.

Utwórz jeden token dla jednej automatyzacji i jednego środowiska.

Otwórz Panel > Konto > Tokeny Personal API. Nadaj tokenowi nazwę identyfikującą jego właściciela i cel, wybierz pełny obszar roboczy, obszar roboczy tylko do odczytu, tylko łącza lub zakresy poszczególnych zasobów, a następnie wybierz okres wygaśnięcia 30, 90 lub 365 dni — lub brak wygaśnięcia, jeśli istnieje już udokumentowany proces rotacji.

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

Przeczytaj kolekcję i zapisz jej wersję przed każdą zmianą.

Treść odpowiedzi zawiera uporządkowane bloki danych i bieżącą wersję liczbową. Ta sama wersja pojawia się w X-OrbitPage-Revision i jako słaby ETag. Zapisz dowolną wartość dla If-Match; nie zgaduj ani nie buforuj go w niepowiązanych uruchomieniach.

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"
  }
}

Użyj PATCH dla najmniejszej zmiany w istniejącym bloku.

URL-koduj identyfikator zwrócony przez GET i wysyłaj tylko te pola, które powinny się zmienić. OrbitPage łączy łatkę z istniejącym blokiem, chroni pola tożsamości i analityki, sprawdza poprawność całej strony pod kątem schematu i planu, a następnie natychmiast publikuje.

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
  }'

Używaj PUT tylko wtedy, gdy sama kolekcja musi się zmienić.

PUT zastępuje kompletną uporządkowaną kolekcję. Jest to operacja dodania bloku, usunięcia bloku lub zmiany kolejności stron. Nie jest to skrót do aktualizacji jednego tytułu: pominięcie bloku powoduje jego usunięcie ze strony.

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());

Użyj natywnego węzła n8n lub tego samego kontraktu z klienta HTTP, wygenerowanego klienta, backendu lub modułu CI.

OrbitPage nie wymaga SDK: kompatybilny jest każdy klient HTTPS, który może wysyłać JSON, uwierzytelnianie Bearer i standardowe żądania GET, POST, PUT, PATCH i DELETE. Poniższe wzorce obejmują części stanowe, które integracja musi jawnie obsługiwać.

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 }

Przeczytaj kompletny przewodnik po natywnych węzłach n8n

Traktuj poświadczenia automatyzacji jako krótkie, obserwowalne cykle życia.

Obszar roboczy obsługuje do dziesięciu aktywnych tokenów osobistych na użytkownika. Lista Konta pokazuje prefiks, zakresy, daty utworzenia i wygaśnięcia każdego tokenu oraz ostatnie użycie. Ostatnio używane znaczniki czasu są celowo zapisywane najwyżej raz na pięć minut.

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

• Nazwij tokeny według systemu i środowiska — na przykład „Akcje GitHub · produkcja”.
• Zmień, tworząc zamiennik, aktualizując tajny magazyn, testując jeden odczyt, a następnie unieważniając stary token.
• Unieważnij natychmiast po podejrzeniu ujawnienia, zmiany właściciela lub wycofania przepływu pracy. Rezygnacja staje się skuteczna od następnego żądania.
• Nie buduj długotrwałego tokena współdzielonego. Oddzielne poświadczenia sprawiają, że dzienniki, rotacja i reakcja na incydenty są zrozumiałe.

Oddział dotyczący statusu HTTP i kodu czytelnego maszynowo.

Błędy używają JSON z błędem i kodem. Nie analizuj ludzkiego zdania, aby kontrolować przepływ pracy. Większość odpowiedzi 4xx wymaga zmiany żądania lub danych uwierzytelniających; w ścieżce automatycznego ponawiania prób znajdują się tylko konflikty wersji i limity szybkości.

Obecne limity pozwalają na 120 żądań na minutę i 5000 dziennie na token. Ochrona przed nadużyciami może je zaostrzyć; zawsze respektuj Retry-After.

Bezpieczna integracja jest wąska, tajna i uwzględnia możliwość rewizji.

Interfejs API REST automatyzacji tokenu osobistego to zarządzana funkcja SaaS.

Repozytorium typu open source zawiera interfejs API Express używany przez dołączony do niego pulpit nawigacyjny, ale ten wewnętrzny interfejs API sesji administratora nie jest tą samą umową na automatyzację z wersjami. Nie wysyłaj tokena op_pat do serwera hostowanego samodzielnie i nie wysyłaj tokenu JWT administratora hostowanego samodzielnie do orbitpage.com/api/v1.