Encryption
Datanumia Home API is secured with TLS 1.2.Rate limiting
The Home API implements a process for limiting and preventing excessive requests in accordance with RFC 6585. API users that regularly hit and ignore rate limits will be blocked from the platform. Get in touch with your Customer Success Manager to get more details about rate limiting and max file sizes.Authorization
Home platform and OAuth2
Authorization within the Home platform is supported through the OAuth2 framework.
Authorization with the Home API is done using an OAuth2 bearer token. It is performed with the Authorization HTTP header. Example:
Access token expiration
An access token expires 10 minutes after being delivered. Once an access token expires, the Home platform will return 401 HTTP status code. A new one must be requested to keep using the Home platform.Refresh token
The Home platform does not support refresh tokens.Resource access using OAuth2
Register your application in the Home platform
Refer to the corresponding section in the Product configuration section.As a machine: Server-to-Server communication
As a Customer (Resource Owner in the OAuth2 terminology), you can access all the resources of your end users in a machine to machine use case through the OAuth2 client credentials flow. It is used:- to manage the lifecycle of person, site and service offer objects within your scope as a customer
- to execute mass processing on all data within your scope