> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Uwierzytelnianie żądań

> Klucze Developer Platform, uprawnienia, ważność i bezpieczne zarządzanie.

## Przegląd

Ta strona opisuje uwierzytelnianie, uprawnienia, ważność i przechowywanie kluczy Developer Platform. Klucz jest związany z jednym projektem i pozwala tylko na przyznane operacje.

## Użycie klucza Developer Platform

Wysyłaj ten nagłówek Authorization w każdym żądaniu.

```http theme={null}
Authorization: Bearer nmp_...
```

Klucze ze zwykłych ustawień zespołu używają przestrzeni roboczych, ich uprawnień i kredytów NoimosAI. Klucze Developer Platform używają oddzielnych projektów, uprawnień i przedpłaconych sald USD.

| Klucz | Zastosowanie | Dane | Rozliczenie |
| - | - | - | - |
| `nmp_` | Developer Platform API | Projekty deweloperskie, wykonania i artefakty | Przedpłacone saldo USD |
| Zwykły klucz NoimosAI | CLI, Local MCP, zwykłe API narzędzi | Przestrzeń robocza NoimosAI | Kredyty NoimosAI |

> [!WARNING]
>
> Klucze nie są zamienne. Nieprawidłowy klucz, brak uprawnień lub salda nie powoduje automatycznej zmiany uwierzytelniania ani rozliczeń.

## Ustawienie uprawnień

Przy tworzeniu wybierz potrzebne uprawnienia.

| Uprawnienie | Dozwolone operacje |
| - | - |
| `project:read` | Odczyt organizacji i projektu klucza |
| `usage:read` | Odczyt rozliczonego użycia i opłat USD bieżącego miesiąca |
| `tools:read` | Pobieranie katalogu i bezpłatnych wycen |
| `tools:execute` | Przesyłanie danych, uruchamianie i anulowanie płatnych zadań |
| `executions:read` | Pobieranie stanu, wyników i adresów pobierania artefaktów |

Oddziel klucze testów połączenia od kluczy płatnych operacji, aby ograniczyć przypadkowe wykonania. Sprawdź wszystkie uprawnienia do projektu, wyceny, wykonania i wyników.

## Kto może tworzyć klucze

Członkowie projektu `ADMIN` i `DEVELOPER` mogą tworzyć klucze. Nawet administrator organizacji musi być jawnie członkiem projektu, aby uzyskać dostęp.

Obowiązują uprawnienia twórcy i projektu. Klucz przestaje działać po wyłączeniu konta twórcy, usunięciu go z projektu lub unieważnieniu klucza.

## Zarządzanie ważnością

Wybierz termin ważności na ekranie tworzenia klucza w Developer Platform, a po utworzeniu sprawdź go na liście kluczy. Pełny klucz pojawia się tylko raz; zapisz go bezpiecznie przed zamknięciem ekranu.

Przed wygaśnięciem utwórz nowy klucz, przełącz integracje i unieważnij stary. Przy podejrzeniu wycieku unieważnij go od razu.

## Bezpieczne przechowywanie

Traktuj klucze jako sekrety serwera, nigdy nieprzekazywane do przeglądarek użytkowników.

* Używaj zmiennych środowiskowych lub menedżera sekretów.
* Nie zapisuj w Git, logach, ekranach błędów ani analityce.
* Nie osadzaj w aplikacjach przeglądarkowych lub mobilnych.
* Oddziel klucze i projekty produkcji, testów i rozwoju.
* Twórz klucze według zastosowań z minimalnymi uprawnieniami.

## Błędy uwierzytelniania

Sprawdź status HTTP i stan klucza.

* `401` — Sprawdź Authorization, pełny klucz, ważność i unieważnienie.
* `403` — Sprawdź uprawnienia oraz dostęp właściciela do projektu.
* `429` — Sprawdź limity żądań, saldo i miesięczne limity organizacji lub projektu.

Jeśli nie wiesz, czy klucz pasuje do endpointu, użyj `GET /tools/project` przed płatnym żądaniem.

## Powiązane strony

Te strony opisują tworzenie kluczy i wspólne specyfikacje.

* [Pierwsze kroki](https://docs.noimosai.com/pl/developers/api/getting-started.md)
* [Dokumentacja API](https://docs.noimosai.com/pl/developers/api/reference.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.