User-level Authentication
As a platform merchant, one of the most important needs is to create sub-merchants programmatically in the KOMOJU system.
To achieve this, we have built various API to facilitate it. For example, the Accounts API allows the platform merchants create sub-merchants under their account and essentially resell the services KOMOJU provides.
However, those API needs the caller to authenticate at a level higher than individual merchants. That is why we created the user-level authentication.
User-level API Keys
Platform operators will register as a user on the KOMOJU platform. In this setup, the user of platform operator will be issued with a user-level authentication key. Please present that key to the KOMOJU system, so that KOMOJU knows that you are representing that platform user.
Presenting the Key
KOMOJU Platform API uses HTTP Basic Authentication to achieve the user-level authenticate. You will need to pass the user-level API key of your platform user as the username (password is not needed). For example
curl -u user_level_key: "https://komoju.com/api/v1/accounts"Examples
As a concrete example, Managing Accounts requires user-level authentication.