🔗 Integrazioni via Token API

Richiedi informative e documenti direttamente dalle tue applicazioni.
Risultati in tempo reale, prezzi trasparenti, nessuna interfaccia grafica richiesta.

🔑 Bearer Token 📄 REST JSON ⚡ Risposta asincrona 📈 Webhook disponibili

1 Autenticazione

Ogni richiesta richiede un Personal Access Token (PAT) nell'header HTTP.

⚙️

Crea un Token API

Vai su Profilo → Token API e genera un nuovo Personal Access Token. Dagli un nome descrittivo (es. "ERP Produzione").

🔒

Includi il token in ogni richiesta

Aggiungi l'header Authorization: Bearer <il_tuo_token> a ogni chiamata API.

💸

Credito pre-pagato

Le richieste scalano dal credito del tuo account. Ricarica da Amministrazione → Credito. Se il credito è insufficiente la richiesta viene rifiutata.

2 Catalogo Prodotti e Prezzi

Tutti i prodotti disponibili via API. I prezzi possono variare — usa GET /api/catalog per ottenerli sempre aggiornati.

Caricamento catalogo...

3 Endpoint disponibili

Base URL: https://certisource.it/api — Documentazione completa →

GET

/catalog

Catalogo prodotti attivi con prezzi aggiornati. Non richiede auth.

POST

/atti-service.php Documenti

Richiedi un documento (visura, atto, bilancio). Parametri: action=richiedi, product_code, vat_number.

POST

/investigations Informative

Crea una nuova informativa. Parametri: investigation_type, target_type, target_vat_number o target_fiscal_code. Supporta webhook_url per notifica al completamento.

POST

/investigations/{id}/start Informative

Avvia l'elaborazione di un'informativa creata in stato draft.

GET

/investigations/{id} Informative

Stato e dettaglio di un'informativa. Campo status: processing → completed.

GET

/investigations/{id}/dossiers Informative

Tutti i dossier dell'informativa (dati aziendali, soggetti, documenti acquisiti).

GET

/auth/token-activity

Lista delle richieste effettuate dal token autenticato con stato e costo.

GET

/auth/token-activity/{token_id}

Dettaglio richieste per un token specifico.

4 Esempi

Esempi pronti all'uso. Sostituisci sk_live_... con il tuo token.

Catalogo prodotti (cURL)

# Nessuna autenticazione richiesta
curl https://certisource.it/api/catalog

Richiedi visura camerale (cURL)

curl -X POST https://certisource.it/atti-service.php \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "action": "richiedi",
    "product_code": "visura_camerale",
    "vat_number": "04058890361"
  }'

Crea informativa con webhook (cURL)

curl -X POST https://certisource.it/api/investigations \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "investigation_type": "company_full",
    "target_type": "company",
    "target_vat_number": "04223920366",
    "webhook_url": "https://tuo-sistema.it/webhook/certisource",
    "webhook_secret": "una_chiave_segreta"
  }'

Verifica stato richieste (JavaScript)

const res = await fetch('https://certisource.it/api/auth/token-activity', {
  headers: { 'Authorization': 'Bearer sk_live_...' }
});
const { data } = await res.json();
console.log(data.tokens); // lista token con conteggio richieste

🔔

Webhook disponibile

Passa webhook_url (e opzionalmente webhook_secret) nella richiesta. Riceverai una notifica POST quando il documento o l'informativa è completata — senza fare polling. Documentazione →