Bygg in Casey-matchning, jobbsökning och Tillväxtradar i ert eget system.

Vad leveransform A (endast API) erbjuder

Leveransform A ger programmatisk åtkomst till samma grenar som handläggar-panelen, exponerade som endpoints. Tre kärnområden:

Kom igång

1. 1

   Skapa ett konto med betalmedel

   Registrera er organisation som partner och koppla ett betalmedel (faktura tills vidare). API-åtkomst kräver ett aktivt avtal eftersom anropen är användningsbaserade.

2. 2

   Få en API-nyckel

   En admin i er organisation skapar nycklar i panelen under Inställningar → API-nycklar. Börja med en test-nyckel (emx_test_) och gå sedan över till live (emx_live_). Klartexten visas EN gång – spara den säkert.

3. 3

   Autentisera

   Skicka nyckeln i X-API-Key-headern på varje anrop. Nyckeln är låst till en region (SE eller FI) och har de scopes ni tilldelats.

4. 4

   Gör ditt första anrop

   Verifiera nyckeln mot /auth/whoami innan ni bygger vidare. Får ni 200 med er partnerinfo är ni redo.

curl https://api.employex.ai/api/v1/external/auth/whoami \
  -H "X-API-Key: emx_live_xxxxxxxxxxxxxxxxxxxx"

{
  "partner": {
    "id": "8f1c...",
    "name": "Exempel Rusta och matcha AB",
    "org_number": "556677-8899",
    "partner_type": "krom_provider",
    "region_code": "SE",
    "status": "active"
  },
  "api_key": {
    "label": "Produktion",
    "prefix": "emx_live_a1b2c3d4",
    "scopes": ["clients:read", "analysis:match"],
    "rate_limit_per_hour": 1000,
    "expires_at": null
  },
  "request_id": "req_3f9a..."
}

Den fullständiga maskinläsbara specifikationen finns som OpenAPI: GET /api/v1/external/openapi.json och interaktiv dokumentation på /api/v1/external/docs.

Autentisering

All åtkomst sker med en API-nyckel i headern X-API-Key. Nycklar genereras av en admin i panelen och bcrypt-hashas i databasen – klartexten lagras aldrig och kan inte återhämtas. Spara den i ert hemliga arkiv.

Scopes & rate limit

Varje nyckel beviljas en uppsättning scopes som styr vilka endpoints den får anropa. Saknas rätt scope returneras 403. Standardkvoten är 1 000 anrop/timme per nyckel; överskriden kvot ger 429 Too Many Requests.

Endpoint-referens

Bas-URL: https://api.employex.ai. Alla externa endpoints ligger under /api/v1/external/.

curl https://api.employex.ai/api/v1/external/analysis/match \
  -X POST \
  -H "X-API-Key: emx_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: match-2026-06-02-0001" \
  -d '{
    "cv_text": "Lagerarbetare med truckkort B1-B4, 5 års erfarenhet ...",
    "limit": 25
  }'

{
  "id": "b2b_match_77c1...",
  "status": "queued",
  "input_mode": "cv_text",
  "requested_limit": 25,
  "created_at": "2026-06-02T09:14:00Z"
}
// Poll GET /analysis/match/{id} eller lyssna på webhook
// "analysis.completed" tills status = "succeeded".

curl https://api.employex.ai/api/v1/external/automations/start \
  -X POST \
  -H "X-API-Key: emx_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "client_user_id": "c0ffee00-1234-5678-90ab-cdef12345678",
    "dry_run": true
  }'

Webhooks

Registrera en endpoint via POST /api/v1/external/webhooks och välj vilka event-typer ni vill ta emot (eller * för alla). Vid registrering får ni ett signeringssecret – det visas EN gång.

POST https://ert-system.se/employex/webhook
X-Employex-Event: application.sent
X-Employex-Delivery: dlv_91ab...
X-Employex-Timestamp: 1769943240
X-Employex-Signature: sha256=9f86d081884c7d659a2feaa0...

# Verifiera: HMAC-SHA256 över "<timestamp>.<rå-body>"
# med er endpoint-secret. Tolerans: 5 min skew.

Priser

Under pilotperioden är alla grenar och anrop 0 kr. Vi sätter användningsbaserade priser tillsammans med er efter piloten – kontakta oss så går vi igenom er volym.

Under pilotperioden sommaren 2026 är alla priser 0 kr. Slutgiltig debitering och kvot fastställs i avtalet efter piloten.

Se hela katalogen av grenar→