Documentazione API

Integra ticket, contatti e knowledge base nei tuoi sistemi.

Integra ticket, contatti e knowledge base nei tuoi sistemi con le API REST di Uppo. La documentazione completa è riservata ai membri del workspace, inclusi i Developer invitati dall’amministratore.

  • API REST con risposte JSON
  • Chiavi per workspace con permessi configurabili
  • Webhook in ingresso firmati e chiamate in uscita autenticate
api.uppo.io
curl -X POST https://api.uppo.io/api/v2/public/ticket/create \
  -H "Api-Key: LA_TUA_API_KEY" \
  -H "Api-Secret: IL_TUO_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Richiesta creata via API",
    "priority": 3,
    "recipient": {
      "email": "customer@example.com",
      "name": "Mario Rossi"
    },
    "message": {
      "body": "Testo della richiesta."
    }
  }'
Esempio di esito webhookticket.updated · HTTP 200

Come si lavora

Autenticazione, limiti e strumenti

Tutto quello che serve per progettare un’integrazione pulita e mantenibile.

Autenticazione

Chiavi API per azienda, con permessi dedicati. Invia Api-Key e Api-Secret nelle intestazioni di ogni chiamata.

Limiti di frequenza

Gestisci 429 e Retry-After. I limiti variano per endpoint e ambiente; ritenta solo scritture idempotenti.

API Playground

Componi la richiesta nel pannello, genera lo snippet ed esportalo per Postman. Esegui le chiamate dal tuo client.

Operazioni

Le risorse principali dell’API

Gestisci ticket, contatti e knowledge base tramite API REST, con risposte JSON e chiavi di accesso dedicate per ogni workspace.

Ticket

POST/ticket/createApri un ticket
POST/ticket/listElenca i ticket
GET/ticket/detail/{id}Leggi un ticket
POST/ticket/replyRispondi a un ticket
POST/ticket/attachment/uploadAllega un file

Contatti

POST/recipient/createCrea un contatto
POST/recipient/listElenca i contatti
GET/recipient/detail/{id}Leggi un contatto
POST/recipient/update/{id}Aggiorna un contatto

Knowledge base

POST/kb/searchCerca nei contenuti
POST/kb/content/listElenca i contenuti
GET/kb/content/detail/{id}Leggi un contenuto
GET/kb/categories/listElenca le categorie

Base: https://api.uppo.io/api/v2/public. Elenco completo nella documentazione API.

Webhook

Eventi in ingresso e in uscita

Uppo scambia eventi con i tuoi sistemi in entrambe le direzioni.

Webhook in ingresso

Ricevi eventi su un endpoint per azienda. Firma e segreto verificano l’origine della chiamata; li trovi nel pannello.

Chiamate in uscita

Le automazioni chiamano i tuoi endpoint con autenticazione Basic o Bearer. Esito e durata restano nel registro.

Progetta l’integrazione con il nostro team

Raccontaci quali sistemi vuoi collegare: ti aiutiamo a disegnare flussi e permessi.