API REST di BladeCRM

L'API REST di BladeCRM ti permette di integrare il CRM con qualsiasi sistema esterno.

Panoramica

Base URL

https://bladecrm.it/api/v1

Formato

• Request: JSON
• Response: JSON
• Encoding: UTF-8

Versioning

L'API è versionata. La versione corrente è v1.

Autenticazione

Tutte le richieste richiedono autenticazione via API Key.

curl -X GET "https://bladecrm.it/api/v1/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Dettagli Autenticazione →

Endpoints Disponibili

Contatti

Metodo	Endpoint	Descrizione
GET	/contacts	Lista contatti
POST	/contacts	Crea contatto
GET	/contacts/{id}	Dettaglio contatto
PUT	/contacts/{id}	Aggiorna contatto
DELETE	/contacts/{id}	Elimina contatto

Documentazione Contatti →

Aziende

Metodo	Endpoint	Descrizione
GET	/companies	Lista aziende
POST	/companies	Crea azienda
GET	/companies/{id}	Dettaglio azienda
PUT	/companies/{id}	Aggiorna azienda
DELETE	/companies/{id}	Elimina azienda

Documentazione Aziende →

Trattative

Metodo	Endpoint	Descrizione
GET	/deals	Lista trattative
POST	/deals	Crea trattativa
GET	/deals/{id}	Dettaglio trattativa
PUT	/deals/{id}	Aggiorna trattativa
DELETE	/deals/{id}	Elimina trattativa
POST	/deals/{id}/change-stage	Cambia stadio

Documentazione Trattative →

Attività

Metodo	Endpoint	Descrizione
GET	/activities	Lista attività
POST	/activities	Crea attività
GET	/activities/{id}	Dettaglio attività
PUT	/activities/{id}	Aggiorna attività
DELETE	/activities/{id}	Elimina attività
POST	/activities/{id}/complete	Segna completata

Documentazione Attività →

Note

Metodo	Endpoint	Descrizione
GET	/notes	Lista note
POST	/notes	Crea nota
GET	/notes/{id}	Dettaglio nota
PUT	/notes/{id}	Aggiorna nota
DELETE	/notes/{id}	Elimina nota

Documentazione Note →

Appuntamenti

Metodo	Endpoint	Descrizione
GET	/appointments	Lista appuntamenti
POST	/appointments	Crea appuntamento
GET	/appointments/{id}	Dettaglio
PUT	/appointments/{id}	Aggiorna
DELETE	/appointments/{id}	Elimina

Documentazione Appuntamenti →

Webhooks

Metodo	Endpoint	Descrizione
GET	/webhooks	Lista webhooks
POST	/webhooks	Crea webhook
DELETE	/webhooks/{id}	Elimina webhook

Documentazione Webhooks →

Response Format

Successo

{
  "success": true,
  "data": {
    "id": 1,
    "first_name": "Mario",
    "last_name": "Rossi",
    "email": "mario@example.com"
  }
}

Lista con Paginazione

{
  "success": true,
  "data": [...],
  "meta": {
    "current_page": 1,
    "last_page": 10,
    "per_page": 25,
    "total": 250
  }
}

Errore

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Il campo email è obbligatorio",
    "details": {
      "email": ["Il campo email è obbligatorio"]
    }
  }
}

Gestione Errori →

Rate Limiting

Le richieste sono limitate per proteggere il servizio:

Piano	Limite
Free	100 req/min
Pro	500 req/min
Enterprise	2000 req/min

Dettagli Rate Limiting →

SDK e Librerie

Attualmente non forniamo SDK ufficiali, ma l'API REST è standard e funziona con qualsiasi client HTTP.

Esempi

cURL:

curl -X GET "https://bladecrm.it/api/v1/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript:

const response = await fetch('https://bladecrm.it/api/v1/contacts', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

Python:

import requests

response = requests.get(
    'https://bladecrm.it/api/v1/contacts',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()

PHP:

$ch = curl_init('https://bladecrm.it/api/v1/contacts');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);
$response = curl_exec($ch);

Supporto

Per domande sull'API:

• 📧 Email: api-support@bladecrm.it
• 📚 Questa documentazione

---

Inizia qui

1. Crea una API Key
2. Prova a listare i contatti
3. Configura i webhooks