Saltar para a documentação
API

Escolher o seu nome de utilizador

Define o nome de utilizador da pessoa de vez, e com ele o seu endereço gratuito.

PUT/account/username

Executa a chamada real no seu espaço de trabalho.

PUT /account/username

Define o nome de utilizador da pessoa de vez, e com ele o seu endereço gratuito.

Exemplo

Requer account:write. username tem de ter de 3 a 30 letras minúsculas, números e pontos isolados depois de passado a minúsculas e com os espaços transformados em pontos. Responde com o nome de utilizador, agora escolhido.

curl
curl -X PUT "$OE/account/username" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "username": "ada.lovelace" }'
Resposta
{  "object": "username",  "username": "ada.lovelace",  "chosen": true,  "address": "[email protected]"}

Depois de escolhido nunca muda, por isso uma segunda escolha é um 409 username_locked. Verifique um primeiro com GET /account/username/availability.

Um nome de utilizador que outra conta tem é um 409 username_taken. Um demasiado curto, demasiado longo, reservado ou não escrito como acima é um 422 invalid_parameter em username, e a mensagem diz qual.

Referência