Feedback

De regel

Zeg wat er gebeurde, waarom, en wat je nu doet. Nooit de schuld bij de gebruiker.

Weten tegenover misgaan

"We weten dit niet" is geen fout. Een onbekend veld en een onbekend KVK-nummer zijn eerlijke antwoorden: ze krijgen de lege ring uit Toestanden, geen foutkleur. Alleen als er echt iets misging, gebruik je de foutkleur, en dan altijd met een icoon en tekst. Kleur alleen zegt nooit dat iets misging.

Een onbekend nummer wekt nooit de indruk dat het bedrijf niet bestaat of dat de gebruiker iets fout deed. Daarop bouwt iemand anders een weigering, en die is dan op ons gebouwd. We schrijven "niet", niet "nog niet": dat zou beloven dat het nummer erbij komt.

Fouten in de API

Elke fout heeft dezelfde vorm, met een code in het Engels en een bericht in het Nederlands:

{
  "error": {
    "code": "company_unknown",
    "message": "We kennen KVK-nummer 00000001 niet. Dat zegt niets over het bedrijf.",
    "docs_url": "https://docs.achtcijfers.nl/foutcodes#company_unknown"
  }
}