API-referens

LeadCallers API är ett REST-API över HTTPS som svarar med JSON. Med det kan du läsa och hantera leads programmatiskt och bygga egna integrationer mot din data. Den här sidan beskriver grunderna — fullständig endpoint-referens får du i admin under Inställningar → API.

Autentisering

Skapa en API-nyckel under Inställningar → API. Skicka den som en Bearer-token i Authorization-headern på varje anrop:

curl https://api.leadcaller.com/v1/leads \
  -H "Authorization: Bearer DIN_API_NYCKEL"

Endpoints

Alla endpoints ligger under https://api.leadcaller.com/v1/ och följer vanliga REST-konventioner — GET för att läsa, POST för att skapa. Listor är paginerade via ?cursor= och ?limit=. Exempel: hämta dina senaste leads med GET /v1/leads, eller en enskild med GET /v1/leads/{id}.

Felhantering

API:et använder vanliga HTTP-statuskoder: 2xx vid lyckat anrop, 4xx vid fel i din förfrågan och 5xx vid fel hos oss. Felsvar innehåller ett maskinläsbart code och ett läsbart message:

{
  "error": {
    "code": "unauthorized",
    "message": "Ogiltig eller saknad API-nyckel."
  }
}

Rate limits

Anrop är hastighetsbegränsade per API-nyckel för att skydda tjänsten. Når du gränsen svarar API:et med 429 Too Many Requests — vänta och försök igen, gärna med exponentiell backoff. Bygg alltid in felhantering för 429 och 5xx i din klient.

Vill du hellre få data skickad till dig i realtid? Använd webhooks i stället för att polla API:et.