Riferimento API

Documentazione completa per l'API REST di Visiono.

Documentazione API

📚 Documentazione API Completa

Documentazione API interattiva con esempi, schemi richiesta/risposta e strumenti di test.

Apri Documentazione API →

Link Rapidi

Risorsa	Descrizione
Documentazione API	Riferimento API interattivo completo
Chiavi API	Crea e gestisci chiavi API
Webhook	Configura notifiche eventi

Panoramica API

URL Base

https://api.visio.now/v1

Autenticazione

Tutte le richieste API richiedono autenticazione via chiave API:

curl -X GET "https://api.visio.now/v1/status" \
  -H "X-API-Key: your-api-key"

Formato Risposta

Tutte le risposte sono JSON:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123"
  }
}

Endpoint Disponibili

Richieste Foto

Metodo	Endpoint	Descrizione
GET	/photo-requests	Elenca tutte le richieste foto
POST	/photo-requests	Crea una nuova richiesta foto *
GET	/photo-requests/{id}	Ottieni una richiesta specifica
DELETE	/photo-requests/{id}	Elimina una richiesta

* Gli utenti del piano free non possono usare i parametri recipient_email o send_email. Vedi limitazioni piano free.

Statistiche

Metodo	Endpoint	Descrizione
GET	/stats	Ottieni statistiche utilizzo e info piano

Link Permanenti

Metodo	Endpoint	Descrizione
GET	/permanent-links	Elenca tutti i Link Permanenti
POST	/permanent-links	Crea un nuovo Link Permanente
GET	/permanent-links/{id}	Ottieni un Link Permanente specifico
PATCH	/permanent-links/{id}	Aggiorna un Link Permanente
DELETE	/permanent-links/{id}	Elimina un Link Permanente

Stato

Metodo	Endpoint	Descrizione
GET	/status	Health check API

Risposte Errore

Formato Errore

{
  "error": {
    "code": "validation_error",
    "message": "I dati forniti non sono validi.",
    "details": {
      "instructions": ["Il campo istruzioni è obbligatorio."]
    }
  }
}

Codici Stato Comuni

Codice	Descrizione
200	Successo
201	Creato
400	Richiesta Non Valida
401	Non Autorizzato
403	Vietato
404	Non Trovato
422	Errore Validazione
429	Rate Limited
500	Errore Server

Rate Limit

Limite	Valore
Richieste per minuto	60
Richieste per ora	1.000

Header rate limit:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1609459200

SDK e Librerie

Attualmente l'API è basata su REST. SDK ufficiali in arrivo.

Strumenti Community

Per l'automazione, considera:

• Integrazione Zapier
• Integrazione Make
• Integrazione n8n

Limitazioni Piano Free

Il Piano Developer Free ha specifiche restrizioni API:

Parametri Email Vietati

Gli utenti del piano free ricevono errori 422 quando usano:

• recipient_email - Parametro indirizzo email
• send_email - Flag booleano per inviare email

Risposta errore:

{
  "message": "The recipient email field is prohibited.",
  "errors": {
    "recipient_email": [
      "Email features are not available on the free plan. Upgrade to send photo requests via email."
    ]
  }
}

Alternativa: Usa il request_url dalle risposte positive per condividere link tramite altri canali (SMS, chat, ecc.).

Differenze Risposta Stats

Le risposte GET /stats del piano free includono:

• plan.email_enabled: false
• usage.is_lifetime_quota: true (100 foto totali, non mensili)
• usage.billing_period_start: null
• usage.billing_period_end: null

Vedi documentazione dettagliata piano free

Supporto

Hai bisogno di aiuto con l'API?

• Controlla la documentazione API completa
• Rivedi la configurazione Chiavi API
• Configura Webhook per aggiornamenti real-time
• Contatta il supporto per esigenze enterprise

Pagine Correlate

• Chiavi API - Setup autenticazione
• Webhook - Notifiche eventi
• Integrazioni - Integrazioni no-code
• Limiti Utilizzo - Dettagli piano free