Source: https://ailoot.ai/docs/pl/cabinet/profile/ Canonical: https://ailoot.ai/docs/pl/cabinet/profile/ Language: pl [API panelu użytkownika](https://ailoot.ai/docs/pl/) # Profil i bezpieczeństwo [Markdown](https://ailoot.ai/docs/pl/cabinet/profile/index.md) Metody, pola żądań i odpowiedzi. W tej sekcji jest 6 metod. Otwórz metodę, aby zobaczyć warunki dostępu, pola żądania i odpowiedź. | Metoda i ścieżka | Opis | Dostęp | | --- | --- | --- | | `PUT /api/v1/user` | Zmiana profilu | Token panelu użytkownika | | `GET /api/v1/user/passkeys` | Lista kluczy dostępu (passkey) | Token panelu użytkownika | | `PUT /api/v1/user/password` | Zmiana hasła | Token panelu użytkownika | | `GET /api/v1/user/profile` | Profil, saldo i powiązania | Token panelu użytkownika | | `GET /api/v1/user/totp/status` | Stan 2FA (TOTP) | Token panelu użytkownika | | `GET /api/v1/user/totp/verification-method` | Sposób weryfikacji TOTP | Token panelu użytkownika | **PUT /api/v1/user** — Zmiana profilu Dostęp: Token panelu użytkownika PUT`/api/v1/user` ## Pola JSON / formularza | Pole | Typ | Wymagane | Walidacja / opis | | --- | --- | --- | --- | | `username` | `string` | nie | ; może być null | | `avatar_url` | `string` | nie | ; może być null | | `balance_notify_enabled` | `boolean` | nie | ; może być null | | `balance_notify_threshold` | `number` | nie | ; może być null | Szablon treści żądania ```json { "username": "PLACEHOLDER_USERNAME (string)", "avatar_url": "PLACEHOLDER_AVATAR_URL (string)", "balance_notify_enabled": "PLACEHOLDER_BALANCE_NOTIFY_ENABLED (boolean)", "balance_notify_threshold": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD (number)" } ``` PLACEHOLDER oznacza Twoje dane wejściowe i ich typ. Zastąp wartości i pozostaw tylko potrzebne pola opcjonalne; znaczników tekstowych nie wysyła się zamiast liczb, wartości boolean, obiektów lub tablic. Schemat żądania: `UpdateProfileRequest` ## Odpowiedź Odpowiedź JSON zawiera code, message i data. Zawartość data opisano w schematach poniżej. Schematy danych odpowiedzi: `User`, `UserProfileResponse`. Pola i typy — na stronach „Schematy danych”. Schemat odpowiedzi, wartości przykładowe ```json { "code": 0, "message": "success", "data": { "id": "PLACEHOLDER_ID (integer)", "email": "PLACEHOLDER_EMAIL (string)", "username": "PLACEHOLDER_USERNAME (string)", "role": "PLACEHOLDER_ROLE (string)", "balance": "PLACEHOLDER_BALANCE (number)", "frozen_balance": "PLACEHOLDER_FROZEN_BALANCE (number)", "concurrency": "PLACEHOLDER_CONCURRENCY (integer)", "status": "PLACEHOLDER_STATUS (string)", "last_active_at": "PLACEHOLDER_LAST_ACTIVE_AT (string)", "created_at": "PLACEHOLDER_CREATED_AT (string)", "updated_at": "PLACEHOLDER_UPDATED_AT (string)", "deleted_at": "PLACEHOLDER_DELETED_AT (string)", "balance_notify_enabled": "PLACEHOLDER_BALANCE_NOTIFY_ENABLED (boolean)", "balance_notify_threshold_type": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD_TYPE (string)", "balance_notify_threshold": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD (number)", "balance_notify_extra_emails": "PLACEHOLDER_BALANCE_NOTIFY_EXTRA_EMAILS (array)", "total_recharged": "PLACEHOLDER_TOTAL_RECHARGED (number)", "rpm_limit": "PLACEHOLDER_RPM_LIMIT (integer)", "api_keys": "PLACEHOLDER_API_KEYS (array)", "avatar_url": "PLACEHOLDER_AVATAR_URL (string)", "email_bound": "PLACEHOLDER_EMAIL_BOUND (boolean)" } } ``` Cechy szczególne: Wszystkie dane osobowe i obiekty są ograniczone do podmiotu JWT. Uwagi: operacja zmienia stan lub kontynuuje jednorazową autoryzację; przykład opisuje kontrakt i nie jest wykonywany. Uwagi: limity wydatków kluczy (quota, quota\_used) są zwracane w odpowiedzi z kluczami, a nie w profilu. frozen\_balance to kwota zarezerwowana, nie można jej traktować jako wolnego salda. Metoda zmienia dane. Ponowne wysłanie jest bezpieczne tylko tam, gdzie przy metodzie podano Idempotency-Key. Jeśli odpowiedź została utracona, najpierw sprawdź wynik (na przykład listę kluczy), a potem zdecyduj, czy ponowić żądanie. **GET /api/v1/user/passkeys** — Lista kluczy dostępu (passkey) Dostęp: Token panelu użytkownika GET`/api/v1/user/passkeys` Odczyt; ID pochodzi z Twojej poprzedniej odpowiedzi ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/passkeys" \ -H "Authorization: Bearer $TOKEN" ``` Treść żądania nie jest wymagana. Przekaż wskazane powyżej parametry w URL. ## Odpowiedź Odpowiedź JSON zawiera code, message i data. Zawartość data opisano w schematach poniżej. Schematy danych odpowiedzi: `PasskeyCredentialSummary`. Pola i typy — na stronach „Schematy danych”. Schemat odpowiedzi, wartości przykładowe ```json { "code": 0, "message": "success", "data": { "id": "PLACEHOLDER_ID (integer)", "name": "PLACEHOLDER_NAME (string)", "created_at": "PLACEHOLDER_CREATED_AT (string)", "last_used_at": "PLACEHOLDER_LAST_USED_AT (string)", "backup": "PLACEHOLDER_BACKUP (boolean)" } } ``` Cechy szczególne: Wszystkie dane osobowe i obiekty są ograniczone do podmiotu JWT. Uwagi: credential pochodzi z navigator.credentials; session\_token z begin. Treść żądania finish \<=65536 bajtów; rejestracja i usunięcie wymagają hasła. **PUT /api/v1/user/password** — Zmiana hasła Dostęp: Token panelu użytkownika PUT`/api/v1/user/password` ## Pola JSON / formularza | Pole | Typ | Wymagane | Walidacja / opis | | --- | --- | --- | --- | | `old_password` | `string` | tak | required | | `new_password` | `string` | tak | required,min=6 | Szablon treści żądania ```json { "old_password": "PLACEHOLDER_OLD_PASSWORD (string)", "new_password": "PLACEHOLDER_NEW_PASSWORD (string)" } ``` PLACEHOLDER oznacza Twoje dane wejściowe i ich typ. Zastąp wartości i pozostaw tylko potrzebne pola opcjonalne; znaczników tekstowych nie wysyła się zamiast liczb, wartości boolean, obiektów lub tablic. Schemat żądania: `ChangePasswordRequest` ## Odpowiedź Odpowiedź JSON zawiera code, message i data. Zawartość data opisano w schematach poniżej. Schemat odpowiedzi, wartości przykładowe ```json { "code": 0, "message": "success", "data": { "message": "VALUE_FROM_RESPONSE" } } ``` Cechy szczególne: Wszystkie dane osobowe i obiekty są ograniczone do podmiotu JWT. Uwagi: operacja zmienia stan lub kontynuuje jednorazową autoryzację; przykład opisuje kontrakt i nie jest wykonywany. Metoda zmienia dane. Ponowne wysłanie jest bezpieczne tylko tam, gdzie przy metodzie podano Idempotency-Key. Jeśli odpowiedź została utracona, najpierw sprawdź wynik (na przykład listę kluczy), a potem zdecyduj, czy ponowić żądanie. **GET /api/v1/user/profile** — Profil, saldo i powiązania Dostęp: Token panelu użytkownika GET`/api/v1/user/profile` Odczyt; ID pochodzi z Twojej poprzedniej odpowiedzi ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \ -H "Authorization: Bearer $TOKEN" ``` Treść żądania nie jest wymagana. Przekaż wskazane powyżej parametry w URL. ## Odpowiedź Odpowiedź JSON zawiera code, message i data. Zawartość data opisano w schematach poniżej. Schematy danych odpowiedzi: `User`, `UserProfileResponse`. Pola i typy — na stronach „Schematy danych”. Schemat odpowiedzi, wartości przykładowe ```json { "code": 0, "message": "success", "data": { "id": "PLACEHOLDER_ID (integer)", "email": "PLACEHOLDER_EMAIL (string)", "username": "PLACEHOLDER_USERNAME (string)", "role": "PLACEHOLDER_ROLE (string)", "balance": "PLACEHOLDER_BALANCE (number)", "frozen_balance": "PLACEHOLDER_FROZEN_BALANCE (number)", "concurrency": "PLACEHOLDER_CONCURRENCY (integer)", "status": "PLACEHOLDER_STATUS (string)", "last_active_at": "PLACEHOLDER_LAST_ACTIVE_AT (string)", "created_at": "PLACEHOLDER_CREATED_AT (string)", "updated_at": "PLACEHOLDER_UPDATED_AT (string)", "deleted_at": "PLACEHOLDER_DELETED_AT (string)", "balance_notify_enabled": "PLACEHOLDER_BALANCE_NOTIFY_ENABLED (boolean)", "balance_notify_threshold_type": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD_TYPE (string)", "balance_notify_threshold": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD (number)", "balance_notify_extra_emails": "PLACEHOLDER_BALANCE_NOTIFY_EXTRA_EMAILS (array)", "total_recharged": "PLACEHOLDER_TOTAL_RECHARGED (number)", "rpm_limit": "PLACEHOLDER_RPM_LIMIT (integer)", "api_keys": "PLACEHOLDER_API_KEYS (array)", "avatar_url": "PLACEHOLDER_AVATAR_URL (string)", "email_bound": "PLACEHOLDER_EMAIL_BOUND (boolean)" } } ``` Cechy szczególne: Wszystkie dane osobowe i obiekty są ograniczone do podmiotu JWT. Uwagi: limity wydatków kluczy (quota, quota\_used) są zwracane w odpowiedzi z kluczami, a nie w profilu. frozen\_balance to kwota zarezerwowana, nie można jej traktować jako wolnego salda. **GET /api/v1/user/totp/status** — Stan 2FA (TOTP) Dostęp: Token panelu użytkownika GET`/api/v1/user/totp/status` Odczyt; ID pochodzi z Twojej poprzedniej odpowiedzi ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/totp/status" \ -H "Authorization: Bearer $TOKEN" ``` Treść żądania nie jest wymagana. Przekaż wskazane powyżej parametry w URL. ## Odpowiedź Odpowiedź JSON zawiera code, message i data. Zawartość data opisano w schematach poniżej. Schematy danych odpowiedzi: `TotpStatusResponse`. Pola i typy — na stronach „Schematy danych”. Schemat odpowiedzi, wartości przykładowe ```json { "code": 0, "message": "success", "data": { "enabled": "PLACEHOLDER_ENABLED (boolean)", "enabled_at": "PLACEHOLDER_ENABLED_AT (integer)", "feature_enabled": "PLACEHOLDER_FEATURE_ENABLED (boolean)" } } ``` Cechy szczególne: Wszystkie dane osobowe i obiekty są ograniczone do podmiotu JWT. Uwagi: secret i setup\_token są poufne; weryfikacja zależy od ustawień TOTP i użytkownika. **GET /api/v1/user/totp/verification-method** — Sposób weryfikacji TOTP Dostęp: Token panelu użytkownika GET`/api/v1/user/totp/verification-method` Odczyt; ID pochodzi z Twojej poprzedniej odpowiedzi ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/totp/verification-method" \ -H "Authorization: Bearer $TOKEN" ``` Treść żądania nie jest wymagana. Przekaż wskazane powyżej parametry w URL. ## Odpowiedź Odpowiedź JSON zawiera code, message i data. Zawartość data opisano w schematach poniżej. Schemat odpowiedzi, wartości przykładowe ```json { "code": 0, "message": "success", "data": { "method": "email" } } ``` Cechy szczególne: Wszystkie dane osobowe i obiekty są ograniczone do podmiotu JWT. Uwagi: secret i setup\_token są poufne; weryfikacja zależy od ustawień TOTP i użytkownika. ## TotpVerificationMethod ```json { "type": "object", "required": [ "method" ], "properties": { "method": { "type": "string", "enum": [ "email", "password" ] } } } ``` Dodatkowe pytania? Prześlij Request ID i opis — pomożemy wyjaśnić sprawę.[Napisz do wsparcia](mailto:support@ailoot.ai) ## Ailoot · Firma i jej portfel projektów Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI. Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach. Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.