Piattaforma per Sviluppatoriv1.0.0 Stabile

Piattaforma per Sviluppatori Spext & API REST

Integra trasferimenti sicuri, crittografati e a tempo nelle tue applicazioni tramite API REST, Webhook in tempo reale e il protocollo MCP per agenti IA.

Endpoint API Base:https://spext.fun/api/v1

OpenAPI 3.1 JSON

Crea Chiave API

HTTP/JSON

API REST v1

Crea e gestisci trasferimenti di testo, file e collegamenti in modo programmatico con payload JSON.

HMAC SHA-256

Webhook in Tempo Reale

Ricevi notifiche push istantanee firmate con HMAC SHA-256 quando i trasferimenti vengono aperti o eliminati.

Strumenti IA

Supporto MCP per IA

Connetti Spext direttamente a Claude Desktop, Cursor e agenti IA autonomi.

AES-256 GCM

Sicurezza Crittografica (SSP)

Crittografia AES-256 GCM con derivazione PBKDF2 per privacy a conoscenza zero.

Lettura Singola

Autodistruzione Atomica

Distruzione immediata dalla memoria e dal database dopo la prima lettura corretta.

Idempotente

Idempotenza Sicura

Evita duplicati in caso di errori di rete usando l'header Idempotency-Key.

Guida Rapida

Inizia a trasferire dati crittografati in 3 semplici passaggi.

Ottieni una Chiave API

Genera la tua chiave spx_sk_ nelle Impostazioni Sviluppatore.

Includi l'Header Authorization

Aggiungi Authorization: Bearer <CHIAVE_API> a ogni richiesta.

Invia il Primo Trasferimento

Usa gli esempi di codice in basso per iniziare subito.

curl -X POST https://spext.fun/api/v1/transfers \
  -H "Authorization: Bearer spx_sk_live_abc123" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"type":"text","text":"Password riservata","expiration":"1h","oneTime":true}'

Autenticazione e Ambiti

Tutte le chiamate richiedono un token Bearer nell'header di autorizzazione.

Le chiavi API sono archiviate unicamente come hash SHA-256.

Authorization

Authorization:Bearer spx_sk_live_...

Ambiti Granulari (Scopes)

Assegna solo i permessi strettamente necessari:

Scope	Açıklama
transfer:create	Crea nuovi trasferimenti di testo, link e file
transfer:read	Controlla stato e metadati dei trasferimenti
transfer:delete	Elimina trasferimenti prima della scadenza
request:create	Crea link di richiesta file con PIN
secret:create	Crea segreti effimeri a visualizzazione singola
room:create	Crea stanze di collaborazione crittografata

SECURITY BEST PRACTICES

Non esporre le chiavi API nel codice client.
Usa variabili d'ambiente sicure.
Verifica l'header X-Spext-Signature per i webhook in ingresso.

Sandbox Interattivo per Test API

SANDBOX SIMULATOR

Testa le chiamate in tempo reale, modifica i parametri e controlla la risposta.

Seleziona Endpoint:

API Key

POSThttps://spext.fun/api/v1/transfers

Click "Invia Richiesta" to execute...

Riferimento API (Endpoints)

REST documentation with schemas, parameters, payloads, and response structures.

POST/transfers

Transfers

Crea un Trasferimento

Crea una condivisione sicura con scadenza temporale.

PARAMETERS

Field	Type	Required	Description
`type`	string	Required	Tipo: text, url o file
`text`	string	Optional	Testo
`expiration`	string	Optional	Durata
`oneTime`	boolean	Optional	Vista singola

Request Payload (JSON)

{
  "type": "text",
  "text": "Segreto",
  "expiration": "1h",
  "oneTime": true
}

Response (201)

{
  "success": true,
  "id": "x8k9m2p1",
  "shareUrl": "https://spext.fun/it/x8k9m2p1"
}

GET/transfers

Transfers

Elenca Trasferimenti

Elenca le condivisioni create con la tua chiave.

PARAMETERS

Field	Type	Required	Description
`limit`	number	Optional	Limite

Response (200)

{
  "transfers": [
    {
      "id": "x8k9m2p1",
      "status": "active"
    }
  ]
}

DELETE/transfers/{id}

Transfers

Elimina Trasferimento

Distrugge immediatamente una condivisione.

PARAMETERS

Field	Type	Required	Description
`id`	string	Required	ID trasferimento

Response (200)

{
  "success": true,
  "message": "Eliminato."
}

POST/secrets

Secrets

Crea Segreto

Crea un segreto con autodistruzione immediata.

PARAMETERS

Field	Type	Required	Description
`secret`	string	Required	Contenuto segreto

Request Payload (JSON)

{
  "secret": "PasswordSegreta"
}

Response (201)

{
  "secretId": "sec_99182",
  "secretUrl": "https://spext.fun/it/secret/sec_99182"
}

POST/requests

Requests

Richiesta File

Link di upload con PIN.

PARAMETERS

Field	Type	Required	Description
`title`	string	Required	Titolo

Request Payload (JSON)

{
  "title": "Documenti"
}

Response (201)

{
  "requestId": "req_87192",
  "pin": "849201"
}

POST/rooms

Collaboration

Crea Stanza Temporanea

Stanza di collaborazione crittografata.

PARAMETERS

Field	Type	Required	Description
`name`	string	Required	Nome

Request Payload (JSON)

{
  "name": "Stanza1"
}

Response (201)

{
  "roomId": "room_1"
}

POST/debug-share

Diagnostics

Condividi Log Anonimizzati

Maschera credenziali e chiavi nei log.

PARAMETERS

Field	Type	Required	Description
`diagnostics`	string	Required	Riepilogo
`logs`	string	Required	Log

Request Payload (JSON)

{
  "diagnostics": "Errore",
  "logs": "Dettagli..."
}

Response (201)

{
  "debugId": "dbg_1"
}

Webhook e Notifiche Push

Ricevi eventi in tempo reale per letture e cancellazioni.

Ogni webhook include l'header X-Spext-Signature per verificare l'autenticità.

transfer.created

Emesso alla creazione del trasferimento.

transfer.completed

Emesso quando il destinatario apre o scarica il contenuto.

transfer.deleted

Emesso alla scadenza o cancellazione.

secret.consumed

Emesso quando il segreto viene consumato.

Verifica della Firma HMAC SHA-256

Ogni webhook include l'header X-Spext-Signature per verificare l'autenticità.

import crypto from 'crypto';
export function verifySpextWebhook(payload, sigHeader, secret) {
  const [t, v1] = sigHeader.split(',').map(x => x.split('=')[1]);
  const hmac = crypto.createHmac('sha256', secret).update(`${t}.${payload}`).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(hmac));
}

Server Model Context Protocol (MCP)

Integra Spext in Claude Desktop, Cursor e agenti autonomi.

Evita che i modelli di linguaggio mostrino credenziali in chiaro, generando link crittografati a tempo.

Configurazione per Claude Desktop

{
  "mcpServers": {
    "spext": {
      "command": "npx",
      "args": ["-y", "@spext/mcp-server"],
      "env": { "SPEXT_API_KEY": "spx_sk_live_..." }
    }
  }
}

AI AGENT TOOLS

spext_create_transfer

Crea link protetti per testi o file

spext_create_secret

Crea segreto a visualizzazione singola

Limiti di Frequenza e Codici di Errore

Regole studiate per la massima affidabilità.

Chiave API Standard120 richieste / minuto

Finestra mobile

Dimensione FileMassimo 25 MiB

Per trasferimento

HTTP Status Codes

Code	Status	Description
`200`	OK	Richiesta eseguita con successo.
`201`	Created	Risorsa creata.
`401`	Unauthorized	Chiave API non valida o assente.
`404`	Not Found	Non trovato o già eliminato.
`429`	Too Many Requests	Limite di frequenza superato.

FAQ per Sviluppatori

Domande frequenti sull'integrazione di Spext.

Accedi e visita Account > Impostazioni Sviluppatore.

Spext API ile Entegrasyona Hemen Başlayın

Geliştirici anahtarınızı 30 saniyede oluşturun, dakikalar içinde güvenli ve şifreli veri transferi yapın.

API Anahtarı Al