API-dokumentation

Integrera Re:runners AI-drivna leadgenerering i dina applikationer

v1.0 REST API JSON responses

Base URL

https://api.rerunner.io/v1

Content-Type

application/json

Autentisering

Re:runner API använder API-nycklar för autentisering. Inkludera din API-nyckel i Authorization-headern för alla förfrågningar.

Curl
curl -H "Authorization: Bearer YOUR_API_KEY" \
    https://api.rerunner.io/v1/leads

API-nycklar
Hitta dina API-nycklar i dashboard under "Inställningar" → "API-nycklar". Håll dem säkra och dela aldrig dem offentligt.

Widget API

Skicka lead

POST

Skicka en ny lead med bilder för AI-analys

POST /api/demo-lead/submit

Parametrar

Parameter Typ Obligatorisk Beskrivning
name string Ja Kundens namn
email string Ja E-postadress
phone string Nej Telefonnummer
category string Ja Däck, Telefoner, Kontorsmöbler, Bilar, Elektronik
description string Nej Produktbeskrivning
images file[] Ja Upp till 3 bilder (max 10MB var)

Exempelsvar

{
  "success": true,
  "message": "Din förfrågan har tagits emot! AI analyserar nu dina bilder...",
  "lead_id": 123,
  "estimated_time": "3-5 sekunder"
}

Kontrollera lead-status

GET

Hämta status och resultat för en lead

GET /api/demo-lead/status/{lead_id}

Exempelsvar (klar analys)

{
  "status": "new",
  "is_complete": true,
  "analysis": {
    "value": 15000,
    "description": "Michelin Pilot Sport 4, 225/45 R17",
    "ai_analysis": {
      "brand": "Michelin",
      "model": "Pilot Sport 4",
      "condition": "bra",
      "visual_rating": 8,
      "functional_rating": 8,
      "size": "225/45 R17",
      "quantity": 4
    }
  }
}

Webhooks

Konfigurera webhooks för att ta emot realtidsnotifieringar när leads analyseras eller uppdateras.

Händelser

  • lead.analyzed - Lead har analyserats med AI
  • lead.validation_failed - Fel kategori upptäckt
  • lead.updated - Lead-status har uppdaterats

Webhook payload

{
  "event": "lead.analyzed",
  "lead_id": 123,
  "timestamp": "2025-08-31T18:30:00Z",
  "data": {
    "status": "new",
    "value": 15000,
    "analysis": {...}
  }
}

Felkoder

HTTP-kod Feltyp Beskrivning
400 bad_request Ogiltig förfrågan eller saknade parametrar
401 unauthorized Ogiltig eller saknad API-nyckel
404 not_found Resurs hittades inte
422 validation_error Valideringsfel i indata
429 rate_limit För många förfrågningar
500 server_error Internt serverfel

Hastighetsbegränsning

Standard-gränser

  • • 1000 förfrågningar per timme
  • • 50 lead-submissioner per dag
  • • 10 samtidiga AI-analyser

Response Headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1630454400

Behöver du hjälp med integrationen?

Vårt utvecklarteam hjälper gärna till med API-implementation och felsökning