PDF ACCESS CLOUD / Documentation

Documentation

Tout pour publier une application HTTP locale.

Démarrage rapide

Avant de commencer

Installez Node.js 22.13 ou une version ultérieure et lancez une application HTTP locale. Créez un compte et un tunnel dans le tableau de bord. Enregistrez le jeton du connecteur lorsqu’il apparaît : vous ne pourrez pas le consulter plus tard.

Créer un tunnel

Gardez le jeton privé

Définissez PAC_CONNECTOR_TOKEN dans votre terminal, puis lancez le connecteur téléchargé. Ce jeton diffère d’une clé API et appartient à un seul tunnel. Renouvelez-le s’il est perdu ou exposé.

Télécharger le connecteur ↓

# 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

Référence API

Créez une clé API dans le tableau de bord et envoyez-la dans l’en-tête Authorization. Les clés API gèrent les tunnels et les clés de votre compte. Protégez-les comme un mot de passe. Les jetons de connecteur servent uniquement au connecteur.

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

Méthode	Point d’accès	Fonction
`GET`	`/api/tunnels`	Lister vos tunnels
`POST`	`/api/tunnels`	Créer un tunnel ; jeton affiché une fois
`DELETE`	`/api/tunnels/:id`	Supprimer et déconnecter un tunnel
`POST`	`/api/tunnels/:id/token`	Renouveler le jeton du connecteur
`GET`	`/api/keys`	Lister les métadonnées des clés
`POST`	`/api/keys`	Créer une clé ; affichée une fois
`DELETE`	`/api/keys/:id`	Révoquer une clé 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": "…"
}

Erreurs

Les erreurs sont renvoyées en JSON. 401 : identifiants absents ou invalides ; 403 : accès interdit ; 404 : ressource indisponible ; 409 : conflit de compte ; 429 : limite atteinte. Un tunnel déconnecté renvoie 503.

OpenAPI 3.1 JSON

Fonctionnement et limites

La bêta transmet les requêtes et réponses HTTP, sans connexions WebSocket applicatives, TCP/UDP arbitraire ni streaming. Les requêtes sont limitées à 2 Mio, les réponses à 4 Mio et le délai à 30 secondes. Le connecteur doit rester actif.

5 tunnels et 10 clés API par compte. Corps des requêtes de 2 Mio et des réponses de 4 Mio maximum et délai de 30 secondes. Les applications WebSocket et les réponses en streaming ne sont pas prises en charge.