Wie authentifiziere ich mich?
Senden Sie Ihren API-Schlüssel bei jeder Anfrage im Header x-api-key, und zwar von dem Server, dessen IP-Adresse für diesen Schlüssel registriert ist.
Jede Anfrage enthält den Schlüssel in einem HTTP-Header:
x-api-key: IHR_API_KEY
Schlüssel haben die Form hma_<prefix>_<secret>. Ein Schlüssel wird nur einmal angezeigt, bei seiner Erstellung, legen Sie ihn also sofort im Secret Store Ihres Servers ab. Bewahren Sie ihn auf dem Server auf: niemals in einem Browser, einer mobilen App oder einem öffentlichen Repository.
Eine Anfrage ohne gültigen Schlüssel wird mit unauthenticated (HTTP 401) abgelehnt. Ein gültiger Schlüssel, der von einer nicht dafür registrierten Adresse verwendet wird, wird mit ip_not_allowed (HTTP 403) abgelehnt.