---
title: Principy API a autentizace
description: Kontrakty, přístupová oprávnění, chyby a bezpečné ukázky.
product: docs
product_version: 0.1.0
api_version: null
locale: cs
type: concept
classification: PUBLIC
lifecycle: stable
owner: miloslav-hub
licence: CC-BY-4.0
slug: api-concepts
---

## Veřejný popis a přístup k API

Veřejná API reference může popisovat službu, která vyžaduje autentizaci. Viditelnost dokumentace neuděluje oprávnění k volání API.
Každá služba určuje vlastní klientské klíče, scopes, limity a životní cyklus. Získání přístupu popisuje její konkrétní návod.

## OpenAPI

OpenAPI popisuje operace, vstupy, odpovědi a bezpečnostní schémata. Strojově čitelný kontrakt má vlastní verzi.
Změna nástroje, který kontrakt zobrazuje, nemění samotné API. Návrhový kontrakt není důkazem nasazené implementace.

## Bezpečné příklady

Příklad používá nefunkční host a zástupný token; nic neposílá do produkce:

```http
GET /example-items HTTP/1.1
Host: api.example.invalid
Authorization: Bearer EXAMPLE_TOKEN_DO_NOT_USE
```

Skutečný klíč patří do bezpečného serverového nastavení příslušného klienta, nikoli do veřejného webu či dokumentace.

## Chyby a limity

401 zpravidla označuje chybějící či neplatnou autentizaci; 403 chybějící oprávnění. Služba může při překročení limitu vrátit 429.
Řiďte se popsaným formátem chyby a retry pravidly konkrétního API. Citlivá data, tokeny a interní stacktrace nepřikládejte k veřejnému hlášení chyby.
