API Aziende

Gestisci le aziende tramite API REST.

Endpoints

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
GET	/companies/{id}/contacts	Contatti dell'azienda

Lista Aziende

GET /api/v1/companies

Query Parameters

Parametro	Tipo	Descrizione
page	int	Pagina
per_page	int	Record per pagina
search	string	Ricerca per nome
industry	string	Filtra per settore

Risposta

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Acme Srl",
      "website": "https://acme.it",
      "industry": "Software",
      "employees": 50,
      "phone": "+39 02 123456",
      "contacts_count": 5
    }
  ],
  "meta": { ... }
}

Creare Azienda

POST /api/v1/companies

Body

{
  "name": "Acme Srl",
  "website": "https://acme.it",
  "industry": "Software",
  "employees": 50,
  "phone": "+39 02 123456",
  "email": "info@acme.it",
  "address": "Via Roma 1",
  "city": "Milano",
  "zip": "20100",
  "country": "Italia"
}

Campi

Campo	Tipo	Obbligatorio
name	string	✅
website	string
industry	string
employees	int
phone	string
email	string
address	string
city	string
zip	string
country	string

Contatti dell'Azienda

GET /api/v1/companies/{id}/contacts

Restituisce tutti i contatti collegati all'azienda.

Esempi

# Lista aziende
curl -X GET "https://bladecrm.it/api/v1/companies" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Crea azienda
curl -X POST "https://bladecrm.it/api/v1/companies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Nuova Azienda Srl"}'