Alcunha da Conta

GETAutenticação necessária

Devolve a alcunha associada à identidade do utilizador autenticado. A marca é resolvida a partir do cabeçalho de pedido X-Brand e a identidade de quem faz a chamada a partir do cabeçalho de pedido X-Client-ID — ambos são definidos pelo gateway e não podem ser falsificados pelo cliente.

Endpoint

GET/account/v1/nickname

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

Autenticação Necessária

Este endpoint requer um token Bearer OAuth2 com o âmbito account_manage e um cabeçalho Deriv-App-ID.

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
  }
}

Estatísticas de margem comercial Saldo

Alguma outra questão? Entrar em contacto