Documents API

General:

Basics:

Base-URL: https://capi.lagerkoll.com/v1/documents/

Parameters in the url should all be encoded and all data sent should be UTF-8

MAX number of requests per minute is set to 200.
When the limit is hit an error with code 429 is returned, with the header "Retry-After" containing the number of seconds you have to wait for your next request.

Headers:

There are 2 ways to be authenticated when using this API. in both ways you add headers to the request.
1) Use an API-key together with store-id. This would be used when communicating machine to machine and no real person is involved. The API-key is available from where you activated the API. The store-id is also available in the same place.
2) Use a user_id and user_token together with a store-id. You get these values from the login-request. The values are connected to a person and are gained when an actual login to the system has been made.

store: <<STORE>>
user_id: <<USER_ID>>
user_token: <<USER_TOKEN>>
api_key: <<API_KEY>>
Accept: application/json
Content-Type: application/json

Errors:

Code	Description
900001	Credentials don't match
900101	Common error
900429	Too many requests
901601	Error getting document
901602	Error copying document

{
  "errorCode" : 900101,
  "errorMessage" : "Something went wrong on the server",
  "errorField" : null,
  "errorData" : null
}

Documents API:

Document

Get document binary

GETUrl: /{document_name : .+}/binary

Headers:

Accept: application/octet-stream or application/json

Get document binary

Body:

Successfull response:

byte[]

{}

Get document metadata

GETUrl: /{document_name : .+}

Headers:

Accept: application/json or application/xml

Get document metadata

Body:

Successfull response:

DocumentsResponseDto

{
    "documentsCount": 5048,
    "pages": 9323,
    "documents": [{
        "readPermissions": [{
            "loginServices": [{}],
            "storeGroupId": 5926,
            "paths": {},
            "name": "name",
            "id": 2830,
            "nativeFeatures": [{}],
            "fields": {},
            "portal": "portal",
            "users": 7453
        }],
        "filename": "filename",
        "ownerName": "ownerName",
        "created": 1751321514670,
        "description": "description",
        "filesize": 661,
        "type": "type",
        "ownerId": 520,
        "version": "version"
    }],
    "pageSize": 3977,
    "page": 6508
}

Get document metadatas

GETUrl:

Headers:

Accept: application/json or application/xml

Get list of document metadatas

Valid parameters:

Parameter	Default value	Allowed values
query
type
page	0
limit	25
order	desc	asc,desc
sort_column	created	type,filename,created

Body:

Successfull response:

DocumentsResponseDto

{
    "documentsCount": 3431,
    "pages": 9453,
    "documents": [{
        "readPermissions": [{
            "loginServices": [{}],
            "storeGroupId": 1424,
            "paths": {},
            "name": "name",
            "id": 873,
            "nativeFeatures": [{}],
            "fields": {},
            "portal": "portal",
            "users": 1737
        }],
        "filename": "filename",
        "ownerName": "ownerName",
        "created": 1751321514670,
        "description": "description",
        "filesize": 6055,
        "type": "type",
        "ownerId": 4045,
        "version": "version"
    }],
    "pageSize": 1402,
    "page": 1355
}

Upload document

POSTUrl:

Headers:

Accept: application/json or application/xml
Content-type: multipart/form-data

Upload document. Max size is 4Mb.

Valid parameters:

Parameter	Description	Default value	Allowed values
file	Inputstream to be uploaded
file
description	Description of file
version	Version of the file
filename	The filename to be stored with the file
read_permissions	List of role ids that have permission to read the file. If empty, the file becomes available for all users. If multiple permissions, send multiple fields with the same id
type	Type of file

Body:

Successfull response:

DocumentDto

{
    "readPermissions": [{
        "loginServices": [{}],
        "storeGroupId": 3137,
        "paths": {},
        "name": "name",
        "id": 8557,
        "nativeFeatures": [{}],
        "fields": {},
        "portal": "portal",
        "users": 2973
    }],
    "filename": "filename",
    "ownerName": "ownerName",
    "created": 1751321514671,
    "description": "description",
    "filesize": 5167,
    "type": "type",
    "ownerId": 4677,
    "version": "version"
}

Copy document

POSTUrl: /{document_name : .+}/copy

Headers:

Accept: application/json or application/xml
Content-type: application/json or application/xml

Copy a document to a new document with new filename and description

Body:

DocumentDto

{
    "filename": "filename",
    "description": "description",
    "type": "type",
    "version": "version"
}

Successfull response:

DocumentDto

{
    "readPermissions": [{
        "loginServices": [{}],
        "storeGroupId": 8884,
        "paths": {},
        "name": "name",
        "id": 9962,
        "nativeFeatures": [{}],
        "fields": {},
        "portal": "portal",
        "users": 6706
    }],
    "filename": "filename",
    "ownerName": "ownerName",
    "created": 1751321514671,
    "description": "description",
    "filesize": 1495,
    "type": "type",
    "ownerId": 5991,
    "version": "version"
}

Delete document

DELETEUrl: /{document_name}

Headers:

Accept: application/json or application/xml
Content-type: application/json

Delete document

Body:

Successfull response:

System Document

Get system document binary

GETUrl: /system/{document_name : .+}/binary

Headers:

Accept: application/octet-stream or application/json

Get system document binary

Body:

Successfull response:

byte[]

{}

Get system document metadatas

GETUrl: /system

Headers:

Accept: application/json or application/xml

Get list of system document metadatas

Body:

Successfull response:

DocumentsResponseDto

{
    "documentsCount": 6793,
    "pages": 4919,
    "documents": [{
        "readPermissions": [{
            "loginServices": [{}],
            "storeGroupId": 5181,
            "paths": {},
            "name": "name",
            "id": 1977,
            "nativeFeatures": [{}],
            "fields": {},
            "portal": "portal",
            "users": 6289
        }],
        "filename": "filename",
        "ownerName": "ownerName",
        "created": 1751321514672,
        "description": "description",
        "filesize": 1892,
        "type": "type",
        "ownerId": 1208,
        "version": "version"
    }],
    "pageSize": 7685,
    "page": 4025
}

Classes:

DocumentDto

Field	Type	Description	Access
description	String		R,W
version	String	Can only be set when creating	R,W
filename	String		R,W
type	String	Can only be set when creating	R,W
filesize	long	Filesize in bytes	R
created	Date		R
ownerId	Long	Id of the user who created the document	R
ownerName	String	Name of the user who created the document	R
readPermissions	List	Roles that have read access to this document	R

DocumentsResponseDto

Field	Type	Access
page	int	R
pages	int	R
pageSize	int	R
documentsCount	int	R
documents	List	R

RoleDto

Field	Type	Description	Accepted values	Access
id	Long			R
storeGroupId	Long			R
name	String			R,W
paths	ArrayList	List of paths role has access to		R,W
fields	HashMap	List of objects and fields that is filtered out when sending data to api and request data from api		R,W
portal	String	What part of Lagerkoll is the role used	ADMIN, SHOP	R,W
users	int	Number of users connected to role		R
loginServices	List	List of login services role has access to		R,W
nativeFeatures	List	List of native features in mobile application role has access to		R,W