PDF ACCESS CLOUD / Documentación

Documentación

Todo lo necesario para publicar una aplicación HTTP local.

Inicio rápido

Antes de empezar

Necesitas Node.js 22.13 o posterior y una aplicación HTTP local en ejecución. Crea una cuenta y un túnel en el panel. Guarda el token del conector cuando aparezca; no se puede recuperar después.

Crear un túnel

Mantén privado el token

Configura PAC_CONNECTOR_TOKEN en tu terminal y ejecuta el conector descargado. El token es distinto de una clave API y pertenece a un solo túnel. Rótalo en el panel si lo pierdes o se expone.

Descargar conector ↓

# Set the token returned when you create a tunnel
read -rs PAC_CONNECTOR_TOKEN
export PAC_CONNECTOR_TOKEN
node connect.mjs --port 3000

# Set the token returned when you create a tunnel
$secureToken = Read-Host 'Connector token' -AsSecureString
$env:PAC_CONNECTOR_TOKEN = [Net.NetworkCredential]::new('', $secureToken).Password
node connect.mjs --port 3000

Referencia API

Crea una clave API en el panel. Envíala en la cabecera Authorization. Las claves API gestionan los túneles y claves de tu cuenta; protégelas como una contraseña. Los tokens de conector solo se usan en el conector.

curl https://pdf-access-cloud.com/api/tunnels \
  -H "Authorization: Bearer $PAC_API_KEY"

Método	Ruta	Función
`GET`	`/api/tunnels`	Listar túneles
`POST`	`/api/tunnels`	Crear túnel; devolver token una vez
`DELETE`	`/api/tunnels/:id`	Eliminar y desconectar un túnel
`POST`	`/api/tunnels/:id/token`	Rotar un token del conector
`GET`	`/api/keys`	Listar metadatos de claves
`POST`	`/api/keys`	Crear clave API; mostrar una vez
`DELETE`	`/api/keys/:id`	Revocar una clave API

POST /api/tunnels
Content-Type: application/json

{"name": "my-preview"}

201 Created
{
  "tunnel": {
    "id": "…",
    "name": "my-preview",
    "slug": "…",
    "url": "https://….tunnel.pdf-access-cloud.com",
    "status": "offline",
    "requests": 0
  },
  "connectorToken": "…"
}

Errores

Los errores devuelven JSON. 401: credenciales ausentes o inválidas; 403: acceso prohibido; 404: recurso no disponible; 409: conflicto de cuenta; 429: límite alcanzado. Un túnel desconectado devuelve 503.

OpenAPI 3.1 JSON

Alcance y límites

La beta reenvía solicitudes y respuestas HTTP. No reenvía WebSockets de aplicaciones, TCP/UDP arbitrario ni respuestas en streaming. Las solicitudes tienen un límite de 2 MiB, las respuestas de 4 MiB y el tiempo de espera de 30 segundos. El conector debe permanecer activo.

Hasta 5 túneles y 10 claves API por cuenta. Los cuerpos de solicitud tienen un límite de 2 MiB, las respuestas de 4 MiB y el tiempo de espera de 30 segundos. No se admiten aplicaciones WebSocket ni respuestas en streaming.