Users

Hantera användaråtkomst i Amili-systemet. Users är associerade med Accounts och kan beviljas åtkomst till alla Creditors inom det Account:et med access group account_admin. Users kan också beviljas mer specifik åtkomst till individuella Creditors genom andra access groups.

User endpoints

• GET /users - Lista alla users (pagerad)
• GET /users/{userId} - Hämta en specifik user
• POST /users - Skapa en ny user

Se Account för att hantera affärsentiteter som users tillhör. Se swagger Application för lista över tillgängliga applikationer. Se swagger Access-Group för dokumentation och hantering av access groups.

Exempel Request

Nedan är ett exempel på att skapa en ny user. Andra operationer följer liknande request/response-mönster med samma datastruktur.

URL: POST /users

Headers:

x-api-key: {your_access_token}
Content-Type: application/json

Request Body:

{
  "account": "674dbeaf08847b9501cc9132",
  "name": "Jane Doe",
  "oauth_type": "microsoft",
  "email_oauth": "jane.doe@domain.se",
  "data_access": [
    {
      "access_group": "60e7fdefc90dc3e2ddd6c7ad"
    }
  ],
  "is_enabled": true,
  "applications": [
    {
      "application": "60e7fdefc90dc3e2ddd6c7af"
    },
    {
      "application": "60e7fdefc90dc3e2ddd6c7b0"
    }
  ]
}

Response Code: 201 Created

Response Body:

{
  "_updated": "Fri, 29 Aug 2025 07:45:25 GMT",
  "_created": "Fri, 29 Aug 2025 07:45:25 GMT",
  "_etag": "8be4d5fc86d77d226b0f83f8593de42334a0a192",
  "_id": "68678ed98d8dc95ece127944",
  "_status": "OK"
}

Parametrar

Request Body Properties

Property	Typ	Obligatorisk	Beskrivning
account	string	Ja	Account ID
name	string	Ja	Användarens fullständiga namn
oauth_type	string	Nej	OAuth-autentiseringstyp (t.ex. "microsoft")*
email_oauth	string	Nej	OAuth-e-postadress
data_access	array	Nej	Lista över access group-tilldelningar
is_enabled	boolean	Nej	Om användaren är aktiv (standard: true)
applications	array	Nej	Lista över applikationstilldelningar
log_invoice_registrations	boolean	Nej	Logga invoice registrations (standard: false)
log_case_registrations	boolean	Nej	Logga case registrations (standard: false)
log_creditor_payments	boolean	Nej	Logga creditor payments (standard: false)
log_creditor_cancellations	boolean	Nej	Logga creditor cancellations (standard: false)
log_creditor_creditings	boolean	Nej	Logga creditor creditings (standard: false)
system_user	boolean	Nej	Om systemanvändare (standard: false)

Data Access Properties

Property	Typ	Obligatorisk	Beskrivning
access_group	string	Ja	Access group ID**
granted_date	string	Nej	Åtkomstbeviljandedatum
access_group_name	string	Nej	Access group-namn
access_group_account_name	string	Nej	Associerat account-namn
access_group_creditor_name	string	Nej	Associerat creditor-namn
access_group_type	string	Nej	Access group-typ (t.ex. "admin")*

Application Properties

Property	Typ	Obligatorisk	Beskrivning
application	string	Ja	Applikations-ID***
application_name	string	Nej	Applikationsnamn (t.ex. "ada_ui")*

Response Properties

Property	Typ	Obligatorisk	Beskrivning
_id	string	Ja	Unik identifierare för user
_created	string	Ja	Skapandetidsstämpel
_updated	string	Ja	Senaste uppdateringstidsstämpel
_etag	string	Ja	Entity tag för samtidighetskontroll
_status	string	Ja	Request-status (t.ex. "OK")*

*) För komplett lista över värden och detaljer, se User
**) För tillgängliga access groups och detaljer, se Access Group
***) För tillgängliga applikationer och detaljer, se Application