تخطَّ إلى المستندات
API

اختر اسم المستخدم الخاص بك

يضبط اسم المستخدم الخاص بالشخص نهائيًا، ومعه عنوانه المجاني.

PUT/account/username

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

PUT /account/username

يضبط اسم المستخدم الخاص بالشخص نهائيًا، ومعه عنوانه المجاني.

مثال

يتطلب account:write. يجب أن يتكوّن username من 3 إلى 30 حرفًا صغيرًا وأرقامًا ونقاطًا منفردة بعد تحويله إلى أحرف صغيرة وتحويل مسافاته إلى نقاط. يرد باسم المستخدم، وقد صار مختارًا.

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

متى اختير لا يتغير أبدًا، لذا يكون الاختيار الثاني 409 username_locked. تحقق من اسم أولًا باستخدام GET /account/username/availability.

اسم المستخدم الذي يملكه حساب آخر يُرجع 409 username_taken. والاسم القصير جدًا أو الطويل جدًا أو المحجوز أو غير المكتوب كما سبق يُرجع 422 invalid_parameter على username، وتقول الرسالة أيها.

المرجع