Automatiza OrbitPage sin compartir una sesión de panel.

Tres límites de credenciales cubren tres trabajos diferentes.

Esta página documenta el límite REST versionado. Un token de OrbitPage no es una clave de proveedor de OpenAI y nunca autentica puntos finales de paneles privados.

Cada operación del tablero admitida, agrupada por la superficie que controla.

Las rutas a continuación son relativas a https://orbitpage.com/api/v1. Método, camino y alcance son el contrato de integración estable; Los esquemas de solicitud, formatos, valores de enumeración y modelos de respuesta se encuentran en el documento OpenAPI 3.1 vinculado. Las rutas desconocidas devuelven 404 y los métodos no compatibles nunca se convierten de forma silenciosa.

Cree un token para una automatización y un entorno.

Abra el Panel de control > Cuenta > Tokens de API personales. Asigne al token un nombre que identifique a su propietario y propósito, elija un espacio de trabajo completo, un espacio de trabajo de solo lectura, solo enlaces o alcances de recursos individuales, luego seleccione una caducidad de 30, 90 o 365 días, o ninguna caducidad cuando ya exista un proceso de rotación documentado.

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

Lee la colección y captura su revisión antes de cada cambio.

El cuerpo de la respuesta contiene los bloques ordenados en datos y la revisión numérica actual. La misma revisión aparece en X-OrbitPage-Revision y como una ETag débil. Guarde cualquiera de los valores para If-Match; no lo adivine ni lo almacene en caché en ejecuciones no relacionadas.

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

Utilice PATCH para el cambio más pequeño en un bloque existente.

Codifica en URL el ID devuelto por GET y envía solo los campos que deben cambiar. OrbitPage fusiona el parche en el bloque existente, protege los campos de identidad y análisis, valida la página completa según su esquema y plan y luego la publica inmediatamente.

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

Utilice PUT solo cuando la colección misma deba cambiar.

PUT reemplaza la colección ordenada completa. Es la operación para agregar un bloque, eliminar un bloque o cambiar el orden de las páginas. No es un atajo para actualizar un título: omitir un bloque lo elimina de la página.

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

Utilice el nodo n8n nativo o el mismo contrato de un cliente HTTP, cliente generado, backend o ejecutor de CI.

OrbitPage no requiere un SDK: cualquier cliente HTTPS que pueda enviar JSON, autenticación de portador y solicitudes estándar GET, POST, PUT, PATCH y DELETE es compatible. Los patrones siguientes cubren las partes con estado que una integración debe manejar explícitamente.

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 }

Lea la guía completa del nodo n8n nativo

Trate las credenciales de automatización como ciclos de vida cortos y observables.

Un espacio de trabajo admite hasta diez tokens personales activos por usuario. La lista de cuentas muestra el prefijo de cada token, sus alcances, sus fechas de creación y caducidad y su uso reciente. Las marcas de tiempo utilizadas por última vez se escriben intencionalmente como máximo una vez cada cinco minutos.

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

• Nombre los tokens por sistema y entorno, por ejemplo, “GitHub Actions · producción”.
• Rotar creando el reemplazo, actualizando el almacén secreto, probando una lectura y luego revocando el token anterior.
• Revocar inmediatamente después de una sospecha de divulgación, cambio de propiedad o retiro del flujo de trabajo. La revocación entra en vigor en la siguiente solicitud.
• No cree un token compartido de larga duración. Las credenciales separadas hacen que los registros, la rotación y la respuesta a incidentes sean comprensibles.

Rama sobre el estado HTTP y el código legible por máquina.

Los errores utilizan JSON con error y código. No analice la oración humana para controlar un flujo de trabajo. La mayoría de las respuestas 4xx requieren cambiar la solicitud o credencial; sólo los conflictos de revisión y los límites de velocidad pertenecen a una ruta de reintento automático.

Los límites actuales permiten 120 solicitudes por minuto y 5000 al día por token. Pueden endurecerse durante la protección contra abusos; respete siempre Retry-After.

Una integración segura es estrecha, secreta y con reconocimiento de revisiones.

La API REST de automatización de token personal es una capacidad SaaS administrada.

El repositorio de código abierto contiene una API Express utilizada por su panel de control incluido, pero esa API de sesión de administración interna no es el mismo contrato de automatización versionado. No envíe un token op_pat a un servidor autohospedado y no envíe un JWT de administrador autohospedado a orbitpage.com/api/v1.