Generate your API Key
Last updated
Last updated
For Programmatic Email API users, if you wish to use a custom from address, please note that the email address with which you use to log into Nomsa must be the same as the address from which you wish to send emails.
Before you start using our API, you have to generate an API key. All users must log into our web application at nomsa.gov.kh to generate this API key. This API key can be used to make API calls and serve to authenticate you to our system.
Keep this API key secret. Unauthorised disclosure of this API key will allow others to impersonate you when calling our system.
To generate this token, navigate to Settings and click on Generate API Key.
We support multiple API keys per account. To distinguish among multiple API keys, choose a label for your API key. This label is permanent and cannot be changed. You can associate each label to the corresponding API key based on the last 5 digits of the API key shown on Nomsa's Settings page (see below).
Enter contact emails that will receive updates regarding this API key. We are aware that our API users often create accounts on Nomsa using email addresses that are not meant to receive incoming emails. As such, it is important to enter email addresses whose inboxes are checked regularly. You can return to this user interface to update this list of contact emails.
After clicking Generate Key, your API key will be successfully created. Your API key will be of the format username_v1_xxxxx. Copy the newly created API key and store it securely. We only store the last 5 digits of your API key. If you lose this API key, we will not be able to recover the API key and you will have to generate a new one.
As mentioned previously, you can associate each label to the corresponding API key based on the last 5 digits of the API key shown on Nomsa's Settings page.
Newly created API keys will be valid for 6 months from the time of creation.
For API keys that had been created prior to our multiple API key feature, the key label will shown as default and the last 5 digits are *****.
To keep your system secure, Nomsa's API keys automatically expire and you should rotate your Nomsa API key on a regular basis. We will send reminders to your the contact emails provided above when prior to expiry. For more information, click here.
