Documentation Index
Fetch the complete documentation index at: https://docs.developers.mijnklantportaal.nl/llms.txt
Use this file to discover all available pages before exploring further.
Adding a Dynamic HTML block to your Page will give you full control over the content on the page. Your server decides what content will be displayed. To let your portal page interact with your server, you should know how we call your endpoint to get the HTML content.
The request
The moment your customer will open your Page, a HTTP-request will done towards the endpoint you have provided. You can protect this endpoint with Basic Auth or an Authentication header. To identify the customer which opened the page, do we send an header with the identifier.
| Header | Description | Example |
|---|
Accept | MijnKlantportaal accepts (and expects) HTML | text/html |
X-Customer-Id | The ID of the customer which opened the page | cst_123abc456def |
X-Page-Id | The ID of the page which needs your HTML content | pag_123abc456def |
The response
The request is covered by authentication, but the response should be protected too. Therefor do we expect a certain content in your response to make your HTML enter your MijnKlantportaal page. Add the following headers to your response:
| Header | Description | Example |
|---|
Content-Type | Let our server know that you, indeed, are sending HTML as response | text/html |
X-Checksum | A checksum to validate that the response is actually coming from your server. See further on this page how to generate this | 1e5e791547c14e581e09... |
X-Checksum header. The data that needs to be used are:
| Type | Value |
|---|
| Algorithm | SHA256 |
| Data | IDOfYourCustomer,IDOfYourPage - For example: cst_123abc456def,pag_123abc456def. Be aware: no spaces! |
| Key | The key you have provided when creating the block |
