Autenticazione
Tutte le richieste API richiedono un'API key valida inviata tramite header HTTP.
Generare una API Key
Per generare una API key:
- Accedi al tuo account FIR CRM su
https://app.fircrm.com - Vai su Impostazioni → API Keys
- Clicca su Genera nuova chiave
- Copia la chiave generata e conservala in modo sicuro
⚠️ Importante
La API key viene mostrata solo al momento della creazione. Se la perdi, dovrai generarne una nuova e revocare quella esistente.
Formato Header
Includi la tua API key nell'header Authorization di ogni richiesta:
Header
Authorization: Bearer fir_your_api_key_here
Esempio completo
cURL
curl -X GET "https://app.fircrm.com/api/v1/contacts" \ -H "Authorization: Bearer fir_your_api_key_here" \ -H "Content-Type: application/json"
Base URL
Tutte le richieste devono essere indirizzate alla seguente base URL:
https://app.fircrm.com/api/v1
Content Type
Per le richieste POST e PUT, includi l'header:
Content-Type: application/json
Permessi
L'accesso API dipende dal piano attivo:
| Piano | Accesso API |
|---|---|
| Free | Nessun accesso API |
| Starter | Solo lettura (GET) |
| Pro | Accesso completo (GET, POST, PUT, DELETE) |
| Business | Accesso completo (GET, POST, PUT, DELETE) |