Przejdź do głównej treści

​
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.
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.
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. 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.