Source: https://ailoot.ai/docs/it/cabinet/profile/ Canonical: https://ailoot.ai/docs/it/cabinet/profile/ Language: it [API dell’area personale](https://ailoot.ai/docs/it/) # Profilo e sicurezza [Markdown](https://ailoot.ai/docs/it/cabinet/profile/index.md) Metodi, campi delle richieste e risposte. La sezione contiene 6 metodi. Apri un metodo per vedere condizioni di accesso, campi della richiesta e risposta. | Metodo e percorso | Descrizione | Accesso | | --- | --- | --- | | `PUT /api/v1/user` | Modifica del profilo | Token dell’area personale | | `GET /api/v1/user/passkeys` | Elenco delle passkey | Token dell’area personale | | `PUT /api/v1/user/password` | Modifica della password | Token dell’area personale | | `GET /api/v1/user/profile` | Profilo, saldo e collegamenti | Token dell’area personale | | `GET /api/v1/user/totp/status` | Stato 2FA (TOTP) | Token dell’area personale | | `GET /api/v1/user/totp/verification-method` | Metodo di verifica TOTP | Token dell’area personale | **PUT /api/v1/user** — Modifica del profilo Accesso: token dell’area personale PUT`/api/v1/user` ## Campi JSON / modulo | Il campo | Tipo | Obbligatorio | Verifica / descrizione | | --- | --- | --- | --- | | `username` | `string` | no | ; può essere null | | `avatar_url` | `string` | no | ; può essere null | | `balance_notify_enabled` | `boolean` | no | ; può essere null | | `balance_notify_threshold` | `number` | no | ; può essere null | Modello del corpo della richiesta ```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 indica il tuo input e il suo tipo. Sostituisci i valori e mantieni solo i campi facoltativi necessari; i segnaposto stringa non vanno inviati al posto di numeri, boolean, oggetti o array. Schema della richiesta: `UpdateProfileRequest` ## Risposta La risposta JSON contiene code, message e data. Il contenuto di data è descritto negli schemi sotto. Schemi dei dati della risposta: `User`, `UserProfileResponse`. Campi e tipi sono nelle pagine «Schemi dei dati». Schema della risposta, valori illustrativi ```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)" } } ``` Particolarità: Tutti i dati personali e gli oggetti sono limitati al soggetto JWT. Particolarità: L’operazione modifica lo stato o prosegue un’autorizzazione monouso; l’esempio descrive il contratto e non viene eseguito. Particolarità: I limiti di spesa delle chiavi (quota, quota\_used) arrivano nella risposta delle chiavi, non nel profilo. frozen\_balance è l’importo riservato e non va considerato saldo libero. Il metodo modifica i dati. Ripetere l’invio è sicuro solo quando il metodo indica Idempotency-Key. Se la risposta va persa, controlla prima il risultato (ad esempio l’elenco delle chiavi), poi decidi se ripetere la richiesta. **GET /api/v1/user/passkeys** — Elenco delle passkey Accesso: token dell’area personale GET`/api/v1/user/passkeys` Lettura; l’ID si ricava dalla risposta precedente che hai ricevuto ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/passkeys" \ -H "Authorization: Bearer $TOKEN" ``` Il corpo della richiesta non è necessario. Passa i parametri indicati sopra nell’URL. ## Risposta La risposta JSON contiene code, message e data. Il contenuto di data è descritto negli schemi sotto. Schemi dei dati della risposta: `PasskeyCredentialSummary`. Campi e tipi sono nelle pagine «Schemi dei dati». Schema della risposta, valori illustrativi ```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)" } } ``` Particolarità: Tutti i dati personali e gli oggetti sono limitati al soggetto JWT. Particolarità: credential è ottenuto da navigator.credentials; session\_token da begin. Corpo di Finish \<=65536 byte; registrazione ed eliminazione richiedono la password. **PUT /api/v1/user/password** — Modifica della password Accesso: token dell’area personale PUT`/api/v1/user/password` ## Campi JSON / modulo | Il campo | Tipo | Obbligatorio | Verifica / descrizione | | --- | --- | --- | --- | | `old_password` | `string` | sì | required | | `new_password` | `string` | sì | required,min=6 | Modello del corpo della richiesta ```json { "old_password": "PLACEHOLDER_OLD_PASSWORD (string)", "new_password": "PLACEHOLDER_NEW_PASSWORD (string)" } ``` PLACEHOLDER indica il tuo input e il suo tipo. Sostituisci i valori e mantieni solo i campi facoltativi necessari; i segnaposto stringa non vanno inviati al posto di numeri, boolean, oggetti o array. Schema della richiesta: `ChangePasswordRequest` ## Risposta La risposta JSON contiene code, message e data. Il contenuto di data è descritto negli schemi sotto. Schema della risposta, valori illustrativi ```json { "code": 0, "message": "success", "data": { "message": "VALUE_FROM_RESPONSE" } } ``` Particolarità: Tutti i dati personali e gli oggetti sono limitati al soggetto JWT. Particolarità: L’operazione modifica lo stato o prosegue un’autorizzazione monouso; l’esempio descrive il contratto e non viene eseguito. Il metodo modifica i dati. Ripetere l’invio è sicuro solo quando il metodo indica Idempotency-Key. Se la risposta va persa, controlla prima il risultato (ad esempio l’elenco delle chiavi), poi decidi se ripetere la richiesta. **GET /api/v1/user/profile** — Profilo, saldo e collegamenti Accesso: token dell’area personale GET`/api/v1/user/profile` Lettura; l’ID si ricava dalla risposta precedente che hai ricevuto ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \ -H "Authorization: Bearer $TOKEN" ``` Il corpo della richiesta non è necessario. Passa i parametri indicati sopra nell’URL. ## Risposta La risposta JSON contiene code, message e data. Il contenuto di data è descritto negli schemi sotto. Schemi dei dati della risposta: `User`, `UserProfileResponse`. Campi e tipi sono nelle pagine «Schemi dei dati». Schema della risposta, valori illustrativi ```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)" } } ``` Particolarità: Tutti i dati personali e gli oggetti sono limitati al soggetto JWT. Particolarità: I limiti di spesa delle chiavi (quota, quota\_used) arrivano nella risposta delle chiavi, non nel profilo. frozen\_balance è l’importo riservato e non va considerato saldo libero. **GET /api/v1/user/totp/status** — Stato 2FA (TOTP) Accesso: token dell’area personale GET`/api/v1/user/totp/status` Lettura; l’ID si ricava dalla risposta precedente che hai ricevuto ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/totp/status" \ -H "Authorization: Bearer $TOKEN" ``` Il corpo della richiesta non è necessario. Passa i parametri indicati sopra nell’URL. ## Risposta La risposta JSON contiene code, message e data. Il contenuto di data è descritto negli schemi sotto. Schemi dei dati della risposta: `TotpStatusResponse`. Campi e tipi sono nelle pagine «Schemi dei dati». Schema della risposta, valori illustrativi ```json { "code": 0, "message": "success", "data": { "enabled": "PLACEHOLDER_ENABLED (boolean)", "enabled_at": "PLACEHOLDER_ENABLED_AT (integer)", "feature_enabled": "PLACEHOLDER_FEATURE_ENABLED (boolean)" } } ``` Particolarità: Tutti i dati personali e gli oggetti sono limitati al soggetto JWT. Particolarità: secret e setup\_token sono segreti; la verifica dipende dalle impostazioni TOTP e dall’utente. **GET /api/v1/user/totp/verification-method** — Metodo di verifica TOTP Accesso: token dell’area personale GET`/api/v1/user/totp/verification-method` Lettura; l’ID si ricava dalla risposta precedente che hai ricevuto ```bash curl --fail-with-body "https://ailoot.ai/api/v1/user/totp/verification-method" \ -H "Authorization: Bearer $TOKEN" ``` Il corpo della richiesta non è necessario. Passa i parametri indicati sopra nell’URL. ## Risposta La risposta JSON contiene code, message e data. Il contenuto di data è descritto negli schemi sotto. Schema della risposta, valori illustrativi ```json { "code": 0, "message": "success", "data": { "method": "email" } } ``` Particolarità: Tutti i dati personali e gli oggetti sono limitati al soggetto JWT. Particolarità: secret e setup\_token sono segreti; la verifica dipende dalle impostazioni TOTP e dall’utente. ## TotpVerificationMethod ```json { "type": "object", "required": [ "method" ], "properties": { "method": { "type": "string", "enum": [ "email", "password" ] } } } ``` Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.[Contatta l’assistenza](mailto:support@ailoot.ai) ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.