Source: https://ailoot.ai/docs/cs/cabinet/profile/ Canonical: https://ailoot.ai/docs/cs/cabinet/profile/ Language: cs [API uživatelského panelu](https://ailoot.ai/docs/cs/) # Profil a zabezpečení [Markdown](https://ailoot.ai/docs/cs/cabinet/profile/index.md) Metody, pole požadavků a odpovědi. V této sekci je 6 metod. Otevřete metodu a prohlédněte si podmínky přístupu, pole požadavku a odpověď. | Metoda a cesta | Popis | Přístup | | --- | --- | --- | | `PUT /api/v1/user` | Úprava profilu | Token uživatelského panelu | | `GET /api/v1/user/passkeys` | Seznam přístupových klíčů (passkey) | Token uživatelského panelu | | `PUT /api/v1/user/password` | Změna hesla | Token uživatelského panelu | | `GET /api/v1/user/profile` | Profil, zůstatek a propojení | Token uživatelského panelu | | `GET /api/v1/user/totp/status` | Stav 2FA (TOTP) | Token uživatelského panelu | | `GET /api/v1/user/totp/verification-method` | Způsob ověření TOTP | Token uživatelského panelu | **PUT /api/v1/user** – Úprava profilu Přístup: token uživatelského panelu PUT`/api/v1/user` ## Pole JSON / formuláře | Pole | Typ | Povinné | Kontrola / popis | | --- | --- | --- | --- | | `username` | `string` | ne | ; může být null | | `avatar_url` | `string` | ne | ; může být null | | `balance_notify_enabled` | `boolean` | ne | ; může být null | | `balance_notify_threshold` | `number` | ne | ; může být null | Šablona těla požadavku ```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 označuje váš vstup a jeho typ. Nahraďte hodnoty a ponechte pouze potřebná nepovinná pole; řetězcové zástupné značky se neodesílají místo čísel, hodnot typu boolean, objektů nebo polí. Schéma požadavku: `UpdateProfileRequest` ## Odpověď Odpověď JSON obsahuje code, message a data. Obsah data je popsán ve schématech níže. Datová schémata odpovědi: `User`, `UserProfileResponse`. Pole a typy najdete na stránkách „Datová schémata“. Schéma odpovědi, hodnoty jsou ilustrativní ```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)" } } ``` Specifika: všechny osobní údaje a objekty jsou omezeny na subjekt JWT. Specifika: operace mění stav nebo pokračuje v jednorázové autorizaci; příklad popisuje kontrakt a neprovádí se. Specifika: výdajové limity klíčů (quota, quota\_used) jsou v odpovědi pro klíče, nikoli v profilu. frozen\_balance je rezervovaná částka a nelze ji považovat za volný zůstatek. Metoda mění data. Opakované odeslání je bezpečné pouze tam, kde je u metody uveden Idempotency-Key. Pokud se odpověď ztratila, nejprve ověřte výsledek (například seznam klíčů) a teprve potom rozhodněte, zda požadavek zopakovat. **GET /api/v1/user/passkeys** – Seznam přístupových klíčů (passkey) Přístup: token uživatelského panelu GET`/api/v1/user/passkeys` Čtení; ID pochází z vaší předchozí odpovědi ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/passkeys" \ -H "Authorization: Bearer $TOKEN" ``` Tělo požadavku není potřeba. Výše uvedené parametry předávejte v URL. ## Odpověď Odpověď JSON obsahuje code, message a data. Obsah data je popsán ve schématech níže. Datová schémata odpovědi: `PasskeyCredentialSummary`. Pole a typy najdete na stránkách „Datová schémata“. Schéma odpovědi, hodnoty jsou ilustrativní ```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)" } } ``` Specifika: všechny osobní údaje a objekty jsou omezeny na subjekt JWT. Specifika: credential pochází z navigator.credentials; session\_token z begin. Tělo požadavku Finish \<=65536 bajtů; registrace a odstranění vyžadují heslo. **PUT /api/v1/user/password** – Změna hesla Přístup: token uživatelského panelu PUT`/api/v1/user/password` ## Pole JSON / formuláře | Pole | Typ | Povinné | Kontrola / popis | | --- | --- | --- | --- | | `old_password` | `string` | ano | required | | `new_password` | `string` | ano | required,min=6 | Šablona těla požadavku ```json { "old_password": "PLACEHOLDER_OLD_PASSWORD (string)", "new_password": "PLACEHOLDER_NEW_PASSWORD (string)" } ``` PLACEHOLDER označuje váš vstup a jeho typ. Nahraďte hodnoty a ponechte pouze potřebná nepovinná pole; řetězcové zástupné značky se neodesílají místo čísel, hodnot typu boolean, objektů nebo polí. Schéma požadavku: `ChangePasswordRequest` ## Odpověď Odpověď JSON obsahuje code, message a data. Obsah data je popsán ve schématech níže. Schéma odpovědi, hodnoty jsou ilustrativní ```json { "code": 0, "message": "success", "data": { "message": "VALUE_FROM_RESPONSE" } } ``` Specifika: všechny osobní údaje a objekty jsou omezeny na subjekt JWT. Specifika: operace mění stav nebo pokračuje v jednorázové autorizaci; příklad popisuje kontrakt a neprovádí se. Metoda mění data. Opakované odeslání je bezpečné pouze tam, kde je u metody uveden Idempotency-Key. Pokud se odpověď ztratila, nejprve ověřte výsledek (například seznam klíčů) a teprve potom rozhodněte, zda požadavek zopakovat. **GET /api/v1/user/profile** – Profil, zůstatek a propojení Přístup: token uživatelského panelu GET`/api/v1/user/profile` Čtení; ID pochází z vaší předchozí odpovědi ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \ -H "Authorization: Bearer $TOKEN" ``` Tělo požadavku není potřeba. Výše uvedené parametry předávejte v URL. ## Odpověď Odpověď JSON obsahuje code, message a data. Obsah data je popsán ve schématech níže. Datová schémata odpovědi: `User`, `UserProfileResponse`. Pole a typy najdete na stránkách „Datová schémata“. Schéma odpovědi, hodnoty jsou ilustrativní ```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)" } } ``` Specifika: všechny osobní údaje a objekty jsou omezeny na subjekt JWT. Specifika: výdajové limity klíčů (quota, quota\_used) jsou v odpovědi pro klíče, nikoli v profilu. frozen\_balance je rezervovaná částka a nelze ji považovat za volný zůstatek. **GET /api/v1/user/totp/status** – Stav 2FA (TOTP) Přístup: token uživatelského panelu GET`/api/v1/user/totp/status` Čtení; ID pochází z vaší předchozí odpovědi ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/totp/status" \ -H "Authorization: Bearer $TOKEN" ``` Tělo požadavku není potřeba. Výše uvedené parametry předávejte v URL. ## Odpověď Odpověď JSON obsahuje code, message a data. Obsah data je popsán ve schématech níže. Datová schémata odpovědi: `TotpStatusResponse`. Pole a typy najdete na stránkách „Datová schémata“. Schéma odpovědi, hodnoty jsou ilustrativní ```json { "code": 0, "message": "success", "data": { "enabled": "PLACEHOLDER_ENABLED (boolean)", "enabled_at": "PLACEHOLDER_ENABLED_AT (integer)", "feature_enabled": "PLACEHOLDER_FEATURE_ENABLED (boolean)" } } ``` Specifika: všechny osobní údaje a objekty jsou omezeny na subjekt JWT. Specifika: secret a setup\_token jsou tajné; ověření závisí na nastavení TOTP a uživatele. **GET /api/v1/user/totp/verification-method** – Způsob ověření TOTP Přístup: token uživatelského panelu GET`/api/v1/user/totp/verification-method` Čtení; ID pochází z vaší předchozí odpovědi ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/totp/verification-method" \ -H "Authorization: Bearer $TOKEN" ``` Tělo požadavku není potřeba. Výše uvedené parametry předávejte v URL. ## Odpověď Odpověď JSON obsahuje code, message a data. Obsah data je popsán ve schématech níže. Schéma odpovědi, hodnoty jsou ilustrativní ```json { "code": 0, "message": "success", "data": { "method": "email" } } ``` Specifika: všechny osobní údaje a objekty jsou omezeny na subjekt JWT. Specifika: secret a setup\_token jsou tajné; ověření závisí na nastavení TOTP a uživatele. ## TotpVerificationMethod ```json { "type": "object", "required": [ "method" ], "properties": { "method": { "type": "string", "enum": [ "email", "password" ] } } } ``` Máte další dotazy? Pošlete Request ID a popis – pomůžeme situaci objasnit.[Napsat podpoře](mailto:support@ailoot.ai) ## Ailoot · Společnost a její portfolio projektů Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI. Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách. Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.