{"revision":"0ed62d2c742f8e20","language":"it","entry":{"id":"aliases","kind":"endpoint","group":"cards","title":"Risolvi o controlla un alias","method":"GET","path":"/v1/aliases/{kind}/{alias}","paths":[],"summary":"Controlla la disponibilità e trova la scheda permanente dietro un alias assegnato.","response":"available e status descrivono l’alias. Un alias assegnato contiene identity. quarantineDays e reusableAt descrivono un nome rilasciato. reservedFor può indicare un’organizzazione riservata.","parameters":[{"name":"kind","description":"u per persone, o per organizzazioni.","in":"path","required":true},{"name":"alias","description":"Da 3 a 32 lettere ASCII, cifre, trattini o trattini bassi. Inizia con una lettera e termina con lettera o cifra.","in":"path","required":true}],"sample":"/v1/aliases/o/veil","access":"public","base":"directory","notes":["La disponibilità non prenota il nome. Per scegliere un alias serve una versione firmata. Conserva il numero permanente perché un nome può essere rilasciato e riassegnato."],"errors":["400 invalid_alias","400 invalid_parameter","401 invalid_api_key","403 api_key_scope","403 api_key_suspended","403 developer_suspended","429 rate_limited","500 internal_error","503 busy"],"related":[],"sections":[{"kind":"code","language":"shell","code":"curl -fsS 'https://veil.rip/v1/aliases/o/veil'"},{"kind":"code","language":"javascript","code":"const response = await fetch(\"https://veil.rip/v1/aliases/o/veil\");\nconst result = await response.json();"}],"live":true,"responses":[{"status":200,"contentType":"application/json","description":"available e status descrivono l’alias. Un alias assegnato contiene identity. quarantineDays e `reusableAt` descrivono un nome rilasciato. reservedFor può indicare un’organizzazione riservata.","fields":[{"name":"kind","type":"string","description":"u per una persona, o per un’organizzazione."},{"name":"alias","type":"string","description":"Alias normalizzato."},{"name":"available","type":"boolean","description":"Indica se può iniziare una nuova richiesta."},{"name":"status","type":"string","description":"available, claimed, reserved_name, publishing o quarantined."},{"name":"url","type":"string","description":"Indirizzo dell’alias controllato."},{"name":"identity","type":"object | null","description":"n e url permanente del titolare corrente."},{"name":"reusableAt","type":"string | null","description":"Data e ora di fine della quarantena."},{"name":"quarantineDays","type":"integer","description":"Durata della quarantena, attualmente 30 giorni."},{"name":"previousIdentity","type":"object | null","description":"Titolare precedente quando indicato durante la quarantena."},{"name":"reservedFor","type":"object | null","description":"Scheda autorizzata a riprendere un alias riservato, se applicabile."}],"example":{"language":"json","code":"{\n  \"kind\": \"u\",\n  \"alias\": \"sample-person\",\n  \"available\": true,\n  \"status\": \"available\",\n  \"url\": \"https://veil.rip/u/sample-person\",\n  \"identity\": null,\n  \"reusableAt\": null,\n  \"quarantineDays\": 30,\n  \"previousIdentity\": null,\n  \"reservedFor\": null\n}"}}],"responseObjects":[],"errorFormat":"json","errorDetails":[{"status":400,"code":"invalid_alias","description":"L’alias non rispetta le regole ASCII del nome.","action":"Usa da 3 a 32 lettere ASCII minuscole, cifre, trattini o trattini bassi; inizia con una lettera e termina con una lettera o cifra.","scope":"endpoint"},{"status":400,"code":"invalid_parameter","description":"Un campo del percorso, della query o del corpo manca, è malformato o fuori intervallo.","action":"Correggi il campo indicato in `error.message` prima di inviare di nuovo.","scope":"endpoint"},{"status":401,"code":"invalid_api_key","description":"La credenziale Bearer è malformata, sconosciuta, scaduta o revocata.","action":"Usa una chiave attiva. Per l’accesso pubblico anonimo, rimuovi del tutto `Authorization`. Credenziali non valide non attivano automaticamente l’accesso anonimo.","scope":"optional-api-key"},{"status":403,"code":"api_key_scope","description":"La chiave API non ha il permesso read o verify, oppure l’endpoint non accetta chiavi Bearer.","action":"Usa il permesso corretto. Le modifiche alle schede e la gestione delle chiavi richiedono una firma del dispositivo.","scope":"optional-api-key"},{"status":403,"code":"api_key_suspended","description":"Questa chiave API è sospesa.","action":"Chiedi allo staff di ripristinarla; un’altra chiave non rimuove la sospensione dell’account.","scope":"optional-api-key"},{"status":403,"code":"developer_suspended","description":"L’account API del titolare è sospeso oppure la scheda titolare non è disponibile.","action":"Controlla l’account titolare e le restrizioni dello staff. Creare un’altra chiave non aggira la sospensione.","scope":"optional-api-key"},{"status":429,"code":"rate_limited","description":"È stato superato un limite anonimo, delle richieste firmate o della chiave API.","action":"Attendi almeno i secondi indicati da `Retry-After`. Condividi coda e budget dei tentativi tra i tuoi processi.","scope":"common"},{"status":500,"code":"internal_error","description":"Si è verificato un errore imprevisto del server. I dettagli interni non vengono restituiti.","action":"Riprova le letture con attese crescenti e un limite. Controlla l’esito delle scritture prima di inviare una nuova operazione firmata.","scope":"common"},{"status":503,"code":"busy","description":"L’applicazione ha raggiunto un limite temporaneo di concorrenza o del database.","action":"Attendi i secondi indicati da `Retry-After` e riprova con attese crescenti e un limite.","scope":"common"}],"responseHeaders":[{"name":"Content-Type","value":"application/json","description":"Usa il tipo dichiarato per scegliere come leggere il corpo."},{"name":"Date","value":"HTTP date","description":"Ora del server. Confrontala con il tuo orologio per firmare le richieste."},{"name":"Retry-After","value":"integer seconds, on rate_limited or busy","description":"Attendi almeno questo intervallo prima di riprovare. Altri codici 429/503 non lo includono necessariamente."}],"documentationUrl":"https://veil.rip/docs/aliases?lang=it","supportsBrowserFetch":true,"browserMode":"fetch"}}