Ler e atualizar o perfil da sua conta

Primeiros passos

Leia o perfil da sua conta FlipLink — nome de exibição, telefone e imagem de perfil — e atualize qualquer um desses campos com uma chamada de atualização parcial.

APIs usadas nesta discussão

Algo impreciso ou desatualizado neste guia?

O que você pode fazer

Sua conta tem um perfil enxuto — um nome de exibição, um número de telefone e uma URL de imagem de perfil. A API permite ler esses valores e atualizar qualquer um deles.

Antes de começar

  • Autentique-se com sua chave de API (veja Autenticação).
  • URL base: https://go.fliplink.me.

Leia seu perfil

GET /api/get-profile retorna o perfil atual da chave de API.

curl -X GET 'https://go.fliplink.me/api/get-profile' \
  -H 'X-Api-Key: YOUR_API_KEY'

Resposta:

{ "Result": "OK", "Name": "Your Account", "Phone": "", "ProfileImage": "" }

Atualize seu perfil

PUT /api/set-profile é uma atualização parcial — qualquer campo que você omitir mantém o valor existente, e você precisa enviar pelo menos um campo. O corpo é form-urlencoded.

CampoO que define
NameNome de exibição
PhoneNúmero de telefone
ProfileImageURL de uma imagem de perfil
curl -X PUT 'https://go.fliplink.me/api/set-profile' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Name=Mark Stevens' \
  --data-urlencode 'Phone=+14155550142' \
  --data-urlencode 'ProfileImage=https://example.com/me.jpg'

Resposta:

{ "Result": "OK", "Message": "Updated successfully" }

Para alterar apenas um campo, envie somente esse campo — os outros ficam intocados.

Erros possíveis

  • Chave de API ausente ou inválida → HTTP 401, uma página HTML de Unauthorized simples — não há corpo JSON.
  • Campo do corpo digitado errado → HTTP 200 com { "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }.

Discussões relacionadas