Använd API v1 för verifikationer

Den här guiden visar hur du arbetar med API v1 för verifikationer i Basly.

Autentisering

Alla /v1-endpoints kräver header:

• X-API-Key: <api_key>

Grundformat

• Content-Type: application/json
• Svar returneras som JSON

Endpoints

Hämta verifikationer

GET https://basly.se/api/v1/verifikationer

Valfri query:

• page (default 1)
• page_size (default 20, max 100)
• from_date (YYYY-MM-DD)
• to_date (YYYY-MM-DD)
• search
• account (kontonummer)

Exempel:

curl -X GET "https://basly.se/api/v1/verifikationer?page=1&page_size=20" \
  -H "X-API-Key: <api_key>"

Skapa verifikation

POST https://basly.se/api/v1/verifikationer

Obligatoriskt:

• Header: X-API-Key
• Body: JSON med minst date, description, entries

Exempel:

{
    "date": "2026-02-28",
    "description": "Manuell verifikation",
    "series": "V",
    "currency": "SEK",
    "exchange_rate": null,
    "is_draft": false,
    "entries": [
        {
            "account_number": 1930,
            "description": "Debet",
            "debit_amount": 1000,
            "credit_amount": 0
        },
        {
            "account_number": 3010,
            "description": "Kredit",
            "debit_amount": 0,
            "credit_amount": 1000
        }
    ]
}

Hämta en verifikation

GET https://basly.se/api/v1/verifikationer/{id}

Obligatoriskt:

• Header: X-API-Key
• Path-param: {id} (UUID)

Uppdatera verifikation

PUT https://basly.se/api/v1/verifikationer/{id}

Obligatoriskt:

• Header: X-API-Key
• Path-param: {id} (UUID)
• Body: de fält du vill uppdatera

Exempel på fält:

• date
• description
• currency
• exchange_rate
• entries

Ta bort verifikation

DELETE https://basly.se/api/v1/verifikationer/{id}

Obligatoriskt:

• Header: X-API-Key
• Path-param: {id} (UUID)

Vanliga felkoder

• 401 Unauthorized: saknad eller ogiltig API-nyckel
• 400 Bad Request: ogiltig request-data
• 404 Not Found: verifikationen hittades inte

Rekommendation för integration

• Logga request-id och endpoint per anrop.
• Validera datum, valuta och balansering innan POST/PUT.
• Hantera 401 och 429 med tydlig återhämtningslogik i klienten.