API Documentation

Integra le funzionalità di LinkBay-CMS nei tuoi flussi aziendali, SaaS, marketplace e automazioni.
Tutte le API sono basate su principi REST e secure-by-design.
Contatta alessio@linkbay-cms.com per onboarding e chiavi API ufficiali.

Quickstart

# Base URL
https://api.linkbay-cms.com/v1/

# Autenticazione (JWT)
Authorization: Bearer <your-token>

Accedi con le stesse credenziali agency/proprietario. I permessi sono segmentati per ruolo e tenant.
Per test avanzati richiedi una API sandbox dedicata.

Principali Endpoint REST

GET /v1/websites

All tenants

Restituisce la lista dei siti/e-commerce dell'agenzia con dati multitenant e paginazione.

curl -X GET "https://api.linkbay-cms.com/v1/websites" -H "Authorization: Bearer <token>"

POST /v1/products

Tenant-specific

Crea un nuovo prodotto nello spazio del tenant. Richiede permesso editor/admin.

curl -X POST "https://api.linkbay-cms.com/v1/products" -H "Authorization: Bearer <token>" -d '{"name":"T-shirt","price":19.90}'

PATCH /v1/orders/{orderId}

Tenant-specific

Aggiorna stato ordine (es. spedito, evaso, annullato).

POST /v1/domains/verify

Agency

Lancia la verifica DNS e il provisioning automatizzato SSL di un nuovo dominio.

Webhook & Integrazioni

Webhook pagamenti completati per sincronizzazione con CRM/contabilità
Integrazione marketplace LinkBay per la gestione plugin e temi
Notifiche via webhook per eventi e-commerce (ordine completato, prodotto esaurito, registrazione cliente…)

Presto disponibili anche API GraphQL (alpha, solo per clienti enterprise su richiesta).

Sicurezza & Ruoli

Autenticazione JWT per ogni chiamata (Access/Refresh Token)
Scope e ruoli: superadmin, agency admin, editor, entwickler, viewer
Ogni endpoint è audit-logged e rate-limited
RBAC e full data isolation multitenant

Chiedi la tua API key personalizzata