Translate the whole site to English: English routes with 301 redirects from the Dutch paths, English UI, docs, seeds and captions, one-time live content migration
This commit is contained in:
@@ -1,24 +1,28 @@
|
||||
# API en authenticatie
|
||||
# API and authentication
|
||||
|
||||
Elke route heeft vier gezichten: HTML, JSON, documentatie en (waar geselecteerd) een assistent-tool. Vraag JSON met `Accept: application/json`.
|
||||
Every route has four faces: HTML, JSON, documentation and (where selected) an assistant tool. Ask for JSON with `Accept: application/json`.
|
||||
|
||||
## Authenticatie
|
||||
## Authentication
|
||||
|
||||
Volgorde van resolutie:
|
||||
Resolution order:
|
||||
|
||||
1. `session` cookie (64 hex tekens) na inloggen op `/auth/login`.
|
||||
2. `X-API-KEY` header met je API-sleutel.
|
||||
3. `Authorization: Bearer <sleutel>`.
|
||||
4. `Authorization: Basic` met naam of e-mail en wachtwoord.
|
||||
1. `session` cookie (64 hex characters) after logging in at `/auth/login`.
|
||||
2. `X-API-KEY` header with your API key.
|
||||
3. `Authorization: Bearer <key>`.
|
||||
4. `Authorization: Basic` with name or email and password.
|
||||
|
||||
Er is geen JWT en geen OAuth.
|
||||
There is no JWT and no OAuth.
|
||||
|
||||
## Voorbeeld
|
||||
## Example
|
||||
|
||||
```bash
|
||||
curl -H 'Accept: application/json' https://molodetz.nl/rol
|
||||
curl -H 'Accept: application/json' https://molodetz.nl/roll
|
||||
```
|
||||
|
||||
## Fouten
|
||||
## Errors
|
||||
|
||||
Fouten hebben de vorm `{"error": {"status": 404, "message": "..."}}`. Validatiefouten geven `422` met `{"error": "validation", "fields": [...], "messages": [...]}`.
|
||||
Errors have the shape `{"error": {"status": 404, "message": "..."}}`. Validation errors return `422` with `{"error": "validation", "fields": [...], "messages": [...]}`.
|
||||
|
||||
## Old paths
|
||||
|
||||
The Dutch paths from before (`/rol`, `/standaard`, `/mensen`, `/binnen`, `/voorwaarden`) answer with a 301 to their English replacement. Query strings are kept.
|
||||
|
||||
Reference in New Issue
Block a user