# Role

V rámci rozhraní CPL API byl zaveden systém uživatelských rolí a oprávnění, jehož cílem je zajistit bezpečný a řízený přístup k jednotlivým funkcionalitám API.

Role umožňují přesně definovat, jaké operace může konkrétní uživatel nebo integrační účet vykonávat. Díky tomu je možné oddělit administrátorské činnosti (např. správa přístupů) od běžného provozního využití API (např. volání vybraných endpointů).

## Přehled Rolí

<table style="border-collapse: collapse; width: 100%; font-family: Arial, sans-serif;">
  <tr style="background-color: #e9ecef;">
    <th style="border: 1px solid #999; padding: 8px; text-align: left;"><strong>Role</strong></th>
    <th style="border: 1px solid #999; padding: 8px; text-align: left;"><strong>Popis</strong></th>
  </tr>
  <tr>
    <td style="border: 1px solid #999; padding: 8px;"><strong>apiAccessManager</strong></td>
    <td style="border: 1px solid #999; padding: 8px;">Tato role umožňuje uživateli vytvářet přístupy do CPL API. Je určena pouze integrátorům PPL.</td>
  </tr>
  <tr>
    <td style="border: 1px solid #999; padding: 8px;"><strong>client</strong></td>
    <td style="border: 1px solid #999; padding: 8px;">Role client je uživateli defaultně nastavována při vytváření přístupu do CPL API a umožňuje přístup ke všem požadavkům CPL API kromě požadavků na vytváření přístupů.</td>
  </tr>
  <tr>
    <td style="border: 1px solid #999; padding: 8px;"><strong>pickupPoints</strong></td>
    <td style="border: 1px solid #999; padding: 8px;">Uživatel této role má přístup pouze ke stahování výdejních míst. Má tedy přístup pouze k metodě <a href="https://ppl-cpl-api.apidog.io/seznam-v%C3%BDdejn%C3%ADch-m%C3%ADst-13465887e0" target="_blank">GET /AccessPoint</a> a k číselníkům.</td>
  </tr>
  <tr>
    <td style="border: 1px solid #999; padding: 8px;"><strong>sandboxAccessManager</strong></td>
    <td style="border: 1px solid #999; padding: 8px;">Umožňuje vytvářet přístupy do <a href="https://sandbox.ppl.cz/" target="_blank">Sandboxu</a>. Tato role je určena pouze integrátorům PPL.</td>
  </tr>
  <tr>
    <td style="border: 1px solid #999; padding: 8px;"><strong>supervisor</strong></td>
    <td style="border: 1px solid #999; padding: 8px;">V roli supervisor má uživatel přístup ke všem metodám CPL API. Je určena pouze pro integrátory.</td>
  </tr>
  <tr>
    <td style="border: 1px solid #999; padding: 8px;"><strong>tracking</strong></td>
    <td style="border: 1px solid #999; padding: 8px;">V této roli má uživatel možnost pouze sledovat zásilky. Má tedy k dispozici pouze metodu <a href="https://ppl-cpl-api.apidog.io/slou%C5%BE%C3%AD-k-z%C3%ADsk%C3%A1n%C3%AD-informac%C3%AD-trackingu-k-z%C3%A1silce-13465913e0" target="_blank">GET /shipment</a>.</td>
  </tr>
</table>