Deriv API
Documentación
Gestión de cuenta

Apodo de la cuenta

GETRequiere autenticación

Devuelve el apodo asociado a la identidad del usuario autenticado. La marca se resuelve a partir del encabezado de solicitud X-Brand y la identidad del llamante a partir del encabezado de solicitud X-Client-ID — ambos son establecidos por el gateway y el cliente no puede falsificarlos.

Endpoint

GET/account/v1/nickname

URL Base: https://api.derivws.com

Códigos de Estado

200OK - Nickname returned successfully
400Bad request - Missing X-Brand or X-Client-ID gateway header
{
  "data": {},
  "errors": [
    {
      "status": 400,
      "code": "InputError",
      "message": "The request could not be processed"
    }
  ],
  "metadata": {
    "endpoint": "/account/v1/nickname",
    "method": "GET",
    "timing": 8
  }
}
401Unauthorized - Invalid or missing authentication
{
  "data": {},
  "errors": [
    {
      "status": 401,
      "code": "InternalError",
      "message": "Invalid or missing authentication credentials"
    }
  ],
  "metadata": {
    "endpoint": "/account/v1/nickname",
    "method": "GET",
    "timing": 6
  }
}
403Forbidden - Access denied
{
  "data": {},
  "errors": [
    {
      "status": 403,
      "code": "InternalError",
      "message": "You do not have permission to access this resource"
    }
  ],
  "metadata": {
    "endpoint": "/account/v1/nickname",
    "method": "GET",
    "timing": 7
  }
}
404Not found - The brand could not be resolved (BrandNotFound) or no identity exists for this client and brand (IdentityNotFound)
{
  "data": {},
  "errors": [
    {
      "status": 404,
      "code": "IdentityNotFound",
      "message": "No identity exists for this client and brand"
    }
  ],
  "metadata": {
    "endpoint": "/account/v1/nickname",
    "method": "GET",
    "timing": 9
  }
}
504Gateway timeout - Upstream service timeout
{
  "data": {},
  "errors": [
    {
      "status": 504,
      "code": "InternalError",
      "message": "The upstream service did not respond in time"
    }
  ],
  "metadata": {
    "endpoint": "/account/v1/nickname",
    "method": "GET",
    "timing": 30000
  }
}
Click to open live chat support. Get instant help from our support team.