Leggere e aggiornare il profilo del tuo account

Primi passi

Leggi il profilo del tuo account FlipLink — nome visualizzato, telefono e immagine del profilo — e aggiorna uno qualsiasi di questi campi con una chiamata di aggiornamento parziale.

API usate in questa discussione

C'è qualcosa di inesatto o non aggiornato in questa guida?

Cosa puoi fare

Il tuo account ha un piccolo profilo — un nome visualizzato, un numero di telefono e l'URL di un'immagine del profilo. L'API ti permette di leggere questi valori e di aggiornarne uno qualsiasi.

Prima di iniziare

  • Autenticati con la tua chiave API (vedi Autenticazione).
  • URL di base: https://go.fliplink.me.

Leggere il tuo profilo

GET /api/get-profile restituisce il profilo attuale associato alla chiave API.

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

Risposta:

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

Aggiornare il tuo profilo

PUT /api/set-profile è un aggiornamento parziale — ogni campo che ometti mantiene il valore esistente, e devi inviare almeno un campo. Il body è form-urlencoded.

CampoCosa imposta
NameNome visualizzato
PhoneNumero di telefono
ProfileImageURL di un'immagine del profilo
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'

Risposta:

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

Per cambiare un solo campo, invia solo quel campo — gli altri restano invariati.

Errori possibili

  • Chiave API mancante o non valida → HTTP 401, una semplice pagina HTML di Unauthorized — non c'è alcun body JSON.
  • Campo del body scritto male → HTTP 200 con { "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }.

Discussioni correlate