🔌 API Documentation

Gleebi API REST Documentation

Integrazione completa tramite OAuth2 Client Credentials. Sincronizza cataloghi, prodotti e risorse per qualsiasi settore aziendale (E-Commerce, Automotive, Immobiliare, Servizi, Musica e Arte Visiva) con supporto automatico ai parametri specifici e ai workflow AI di Gleebi.

🔐

Autenticazione OAuth2

Client Credentials Flow (Bearer Token)

💼 Requisito Account Custom / Enterprise

Per collegare automaticamente i plugin WooCommerce, PrestaShop o sistemi esterni tramite API REST, sono necessarie le chiavi API Client (Client ID & Client Secret). La generazione delle chiavi API è una funzionalità riservata esclusivamente agli utenti con Piano Personalizzato (Custom / Enterprise).

Se possiedi un Account Personalizzato, genera le tue credenziali API dalla dashboard Gleebi: Impostazioni → Credenziali API REST.

✔ Client ID

✔ Client Secret

✔ OAuth2 Bearer Token

Richiesta Token OAuth2

POST /oauth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "TUO_CLIENT_ID",
  "client_secret": "TUO_CLIENT_SECRET",
  "scope": "*"
}

Risposta Token

{
  "token_type": "Bearer",
  "expires_in": 31536000,
  "access_token": "eyJhbGciOi..."
}

🏢

Tipi Azienda & Schema Parametri

Gestione polimorfica in base al settore di appartenenza

Gleebi personalizza la generazione dei contenuti AI e la struttura dei dati in base alla tipologia di azienda collegata. Puoi ispezionare gli schemi dinamici e i campi validati in qualsiasi momento richiamando l'endpoint schema:

GET /api/products/schema

🔍 Come l'API riconosce il tipo di azienda/prodotto

Quando invii una richiesta POST /api/products o PUT /api/products/{id}, Gleebi determina la tipologia aziendale ed applica i campi specifici secondo questo ordine di priorità:

1. Campo "type" nel JSON: Puoi passare la stringa del settore (es. "type": "car_rental", "type": "real_estate", "type": "service", "type": "music", "type": "visual", "type": "ecommerce").
2. ID Sottocategoria: In alternativa, puoi passare "subcategory_id": 20 oppure "content_subcategory_id": 20 (es. 20 per Automotive, 40 per Immobiliare, 50 per Servizi, 10 per Musica, 11 per Arte Visiva, 30 per E-Commerce).
3. Riconoscimento Automatico Utente (Default): Se nel JSON non invii né type né subcategory_id, l'API legge la sottocategoria registrata nel profilo dell'account Gleebi proprietario della chiave API REST.

Settori Supportati & Payload di Esempio

1. E-Commerce & Vendita Prodotti

subcategory_id: 30 | type: ecommerce

Supporta prodotti fisici, abbigliamento, magazzino e codici identificativi (SKU, EAN).

POST /api/products
{
  "type": "ecommerce",
  "name": "Giacca in Pelle Vintage",
  "URL": "https://tuoshop.com/prodotti/giacca-pelle",
  "price": 149.90,
  "old_price": 189.90,
  "SKU": "JKT-LEATHER-01",
  "EAN": "8001234567890",
  "brand": "Heritage Leather",
  "size": "L",
  "color": "Marrone",
  "material": "Pelle Naturale",
  "stock": 15,
  "thumbnailURL": "https://tuoshop.com/img/giacca.jpg"
}

2. Automotive & Noleggio Auto

subcategory_id: 20 | type: car_rental

Parametri specifici per concessionarie auto, flotta veicoli e noleggio a lungo/breve termine.

POST /api/products
{
  "type": "car_rental",
  "name": "Audi A4 Avant 2.0 TDI",
  "URL": "https://noleggioauto.com/veicoli/audi-a4",
  "price": 75.00,
  "vehicle_type": "SUV / Station Wagon",
  "km": 45000,
  "fuel_type": "Diesel",
  "transmission": "Automatico",
  "registration_year": 2023,
  "engine_size": 1968,
  "horsepower": 190,
  "daily_rate": 75.00,
  "deposit": 500,
  "license_plate": "FX123AB",
  "thumbnailURL": "https://noleggioauto.com/img/audi.jpg"
}

3. Immobiliare & Affitti

subcategory_id: 40 | type: real_estate

Campi dedicati ad agenzie immobiliari, appartamenti, ville e locali commerciali.

POST /api/products
{
  "type": "real_estate",
  "name": "Attico Panoramico Vista Mare",
  "URL": "https://immobiliare.com/immobili/attico-vista-mare",
  "price": 1200.00,
  "property_type": "Attico",
  "rooms": 4,
  "bathrooms": 2,
  "square_meters": 110,
  "energy_class": "A2",
  "floor_number": 5,
  "has_elevator": true,
  "has_garage": true,
  "has_garden": false,
  "has_pool": true,
  "monthly_rent": 1200.00,
  "thumbnailURL": "https://immobiliare.com/img/attico.jpg"
}

4. Servizi & Consulenze Professionali

subcategory_id: 50 | type: service

Gestione appuntamenti, consulenze online/in presenza, trattamenti estetici e servizi professionali.

POST /api/products
{
  "type": "service",
  "name": "Consulenza Legale Strategica",
  "URL": "https://studiolegale.com/servizi/consulenza-strategica",
  "price": 150.00,
  "service_type": "Consulenza Legale",
  "service_duration": 60,
  "price_on_request": false,
  "appointment_required": true,
  "home_service": false,
  "online_service": true,
  "booking_notice_hours": 24,
  "thumbnailURL": "https://studiolegale.com/img/service.jpg"
}

5. Musica & Audio Creator

subcategory_id: 10 | type: music

Tracce musicali, singoli Spotify, campionamenti audio e licenze digitali.

POST /api/products
{
  "type": "music",
  "name": "Midnight Drive (Synthwave Beat)",
  "URL": "https://music.com/tracks/midnight-drive",
  "price": 49.00,
  "genre": "Synthwave / Electronic",
  "bpm": 120,
  "track_duration": 215,
  "album_name": "Neon Dreams EP",
  "isrc": "IT-A01-24-00001",
  "digital_file_url": "https://music.com/files/master.wav",
  "license_type": "Commerciale",
  "thumbnailURL": "https://music.com/img/cover.jpg"
}

6. Visual Art & Grafica

subcategory_id: 11 | type: visual

Illustrazioni digitali, modellazione 3D, branding e opere visive.

POST /api/products
{
  "type": "visual",
  "name": "Brand Identity Kit 3D",
  "URL": "https://art.com/portfolio/brand-kit",
  "price": 350.00,
  "style": "Minimal / 3D Render",
  "resolution": "4K / 300 DPI",
  "file_format": "PSD, AI, OBJ",
  "estimated_hours": 12,
  "custom_cta": "Richiedi Custom Quote",
  "thumbnailURL": "https://art.com/img/brandkit.jpg"
}

📦

Endpoints Prodotti REST

Operazioni CRUD e filtraggio per settore

Base Endpoint → /api/products

GET /api/products

Ritorna la lista dei prodotti sincronizzati con attributi specifici in base al tipo azienda.

Filtri opzionali: ?subcategory_id=20 oppure ?type=car_rental

GET /api/products/{id}

Ritorna il dettaglio completo del singolo prodotto e il blocco specific_parameters.

POST /api/products

Crea un nuovo prodotto nel sistema, eseguendo le validazioni standard e quelle specifiche del settore.

PUT /api/products/{id}

Aggiorna un prodotto esistente e i suoi dati correlati.

DELETE /api/products/{id}

Rimuove il prodotto dal catalogo Gleebi.

🔄

Batch Synchronization

Sincronizzazione massiva di cataloghi (WooCommerce / PrestaShop)

Endpoint ad alte prestazioni utilizzato dai plugin ufficiali Gleebi per elaborare e sincronizzare cataloghi complessi in background.

POST /sync/batch/create

{
  "sync_callbackURL": "https://tuoshop.com/module/gleebi/sync",
  "products": [
    {
      "id_product": 10,
      "name": "Customizable Mug",
      "price": 12.50,
      "SKU": "MUG-001",
      "thumbnailURL": "https://tuoshop.com/mug.jpg"
    }
  ]
}

🧪

Esempio di Flusso cURL

Test rapido in ambiente di produzione

# 1) OTTIENI IL TOKEN
curl -X POST https://gleebi.it/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "IL_TUO_CLIENT_ID",
    "client_secret": "IL_TUO_CLIENT_SECRET"
  }'

# 2) RICHIEDI LO SCHEMA DEL TUO SETTORE
curl -X GET https://gleebi.it/api/products/schema?type=car_rental \
  -H "Authorization: Bearer IL_TUO_ACCESS_TOKEN"

# 3) CREA UN PRODOTTO CON PARAMETRI SPECIFICI
curl -X POST https://gleebi.it/api/products \
  -H "Authorization: Bearer IL_TUO_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "car_rental",
    "name": "Fiat 500 Hybrid",
    "URL": "https://noleggio.com/fiat-500",
    "price": 45.00,
    "vehicle_type": "Utilitaria",
    "fuel_type": "Ibrida",
    "transmission": "Manuale",
    "license_plate": "GH789EF"
  }'