Autenticazione API

Autentica le richieste API di LastDatabase supportate utilizzando una chiave API cliente attiva nell'intestazione HTTP Authorization.

Crea una chiave API

1. Accedi al tuo account cliente LastDatabase.
2. Apri Gestione API.
3. Assicurati che sia attivo un piano API appropriato.
4. Crea una chiave API e assegnale un nome descrittivo per l'applicazione.
5. Conservare le credenziali in un luogo sicuro prima di utilizzarle in produzione.

Utilizza chiavi separate quando desideri una visibilità indipendente a livello di applicazione o una revoca più semplice delle credenziali.

Autenticazione del portatore

Invia la chiave API utilizzando l'intestazione HTTP Authorization standard:

Autorizzazione: Portatore YOUR_API_KEY

Per le richieste JSON POST, inviare anche:

Accetta: application/json Content-Type: application/json

Esempio

curl -X GET \ "https://lastdatabase.com/api/integrations/v1/credits" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

Il server esegue l'hashing del token Bearer fornito e lo associa a una chiave API attiva. Le chiavi disabilitate non sono accettate.

Errori di autenticazione

Token API mancante

Una richiesta a un endpoint protetto senza un token Bearer restituisce HTTP 401.

{ "status": false, "message": "Token API mancante." }

Token non valido o disabilitato

Un token che non corrisponde a una chiave API attiva restituisce anche un errore HTTP 401.

{ "status": false, "message": "Token API non valido." }

Limiti giornalieri delle richieste API

Ogni richiesta API autenticata incrementa il contatore di utilizzo associato alla chiave API. Il contatore di utilizzo si azzera quando la data dell'ultimo utilizzo memorizzata differisce dalla data corrente del server.

Quando used_today raggiunge la chiave daily_limit, il middleware restituisce HTTP 429.

{ "status": false, "message": "Limite giornaliero API superato." }

Piani API attuali

Verificare l'utilizzo attuale

GET /api/integrations/v1/credits

L'endpoint Credits restituisce il limite giornaliero della chiave autenticata, le richieste utilizzate oggi e le richieste rimanenti, insieme ai record di abbonamento ai lead rimanenti.

Sicurezza delle credenziali

• Archivia le chiavi API nelle variabili d'ambiente o in un gestore di segreti dedicato.
• Conserva le credenziali lato server.
• Non inserire le chiavi API nel codice JavaScript del browser.
• Non pubblicare le chiavi su GitHub, GitLab o altri repository di codice sorgente.
• Non includere credenziali di accesso attive nella documentazione o negli screenshot.
• Utilizzare HTTPS per tutte le richieste.
• Limitare l'accesso alle variabili dell'ambiente di produzione.
• Disabilitare tempestivamente le chiavi inutilizzate o compromesse.

Esempio di variabile d'ambiente

LASTDATABASE_API_KEY=la_tua_chiave_API_privata

La tua applicazione può leggere il segreto in fase di esecuzione anziché memorizzarlo direttamente nel codice sorgente.

Rotazione e revoca delle chiavi

Quando si sostituisce una credenziale, è necessario creare una nuova chiave, aggiornare l'applicazione autorizzata, verificare che la nuova chiave funzioni correttamente e quindi disabilitare la vecchia chiave. Ciò riduce i tempi di inattività non necessari durante la rotazione programmata.

Se si sospetta che una chiave sia stata esposta, interromperne l'utilizzo e disabilitarla tramite la Gestione API. Non fare affidamento sul nascondere una chiave esposta nel codice dell'applicazione dopo che è già stata divulgata.

Esempi di autenticazione

PHP

$apiKey = getenv('LASTDATABASE_API_KEY'); $headers = [ 'Authorization: Bearer ' . $apiKey, 'Accept: application/json', ];

Python

import os headers = { "Authorization": f"Bearer {os.environ['LASTDATABASE_API_KEY']}", "Accept": "application/json", }

Node.js

const headers = { Authorization: `Bearer ${process.env.LASTDATABASE_API_KEY}`, Accept: "application/json" };

Continua con la guida alla ricerca e al filtraggio tramite API oppure torna alla documentazione completa delle API.