Documentazione API
Riferimento completo REST API con esempi, dettagli autenticazione e guide integrazione per sviluppatori.
Panoramica API
Sicuro
Autenticazione OAuth 2.0 e API key con crittografia HTTPS
Veloce
Ottimizzato per prestazioni con tempi di risposta sotto i 200ms
RESTful
Principi REST standard con formato richiesta/risposta JSON
URL Base
https://api.digitallog.it/v1Tutte le richieste API dovrebbero essere fatte a questo URL base con il percorso endpoint appropriato.
Autenticazione
Autenticazione API Key
Tutte le richieste API richiedono autenticazione utilizzando una API key. Includi la tua API key negli header della richiesta:
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
🔑 Ottenere la Tua API Key
Contatta il tuo project manager o invia email a api@digitallog.it per ottenere le tue credenziali API. Le API keys sono uniche per ogni progetto e dovrebbero essere mantenute sicure.
Rate Limiting
Le richieste API sono limitate per garantire un uso equo e prestazioni ottimali:
- Piano Standard: 1.000 richieste per ora
- Piano Premium: 10.000 richieste per ora
- Piano Enterprise: Limiti personalizzati basati su accordo
Rate Limit Headers
X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 999 X-RateLimit-Reset: 1609459200
Endpoint API
/api/projectsRecupera una lista di tutti i progetti
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
| page | integer | Numero pagina per paginazione |
| limit | integer | Numero di elementi per pagina (max 100) |
| status | string | Filtra per stato progetto |
/api/projects/{id}Recupera dettagli di un progetto specifico
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
| id | string | Identificatore unico del progetto |
/api/projectsCrea un nuovo progetto
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
| name | string | Nome progetto (richiesto) |
| description | string | Descrizione progetto |
| type | string | Tipo progetto (web, mobile, etc.) |
/api/projects/{id}Aggiorna un progetto esistente
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
| id | string | Identificatore unico del progetto |
| name | string | Nome progetto aggiornato |
| status | string | Stato progetto aggiornato |
Formato Risposta
Risposta di Successo
{
"success": true,
"data": {
"id": "proj_123456",
"name": "E-commerce Platform",
"status": "active",
"created_at": "2025-01-15T10:30:00Z"
},
"meta": {
"timestamp": "2025-01-22T14:30:00Z",
"version": "1.0"
}
}Risposta di Errore
{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "Missing required parameter: name",
"details": {
"field": "name",
"issue": "required"
}
},
"meta": {
"timestamp": "2025-01-22T14:30:00Z",
"request_id": "req_789012"
}
}Codici di Stato HTTP
Successo - Richiesta completata con successo
Creato - Risorsa creata con successo
Richiesta Non Valida - Parametri richiesta non validi
Non Autorizzato - Autenticazione non valida o mancante
Vietato - Permessi insufficienti
Non Trovato - La risorsa non esiste
Troppe Richieste - Limite di rate superato
Errore Server Interno - Errore lato server
SDK e Librerie
Forniamo SDK ufficiali e librerie per rendere l'integrazione più facile su diverse piattaforme.
JavaScript/Node.js
SDK JavaScript ufficiale per applicazioni web e Node.js
npm install digitallog-sdkC# / .NET
SDK .NET ufficiale per applicazioni C#
dotnet add package Digitallog.SDKPython
SDK Python ufficiale per applicazioni Python
pip install digitallog-pythonPronto per Iniziare il Tuo Progetto?
Discutiamo di come la nostra esperienza può aiutarti a raggiungere i tuoi obiettivi.