Je accountprofiel lezen en bijwerken

Aan de slag

Lees je FlipLink-accountprofiel — weergavenaam, telefoon en profielafbeelding — en werk elk van die velden bij met een partiële update-aanroep.

API's die in deze discussie worden gebruikt

Iets onjuist of verouderd in deze gids?

Wat je kunt doen

Je account heeft een klein profiel — een weergavenaam, een telefoonnummer en een URL van een profielafbeelding. Met de API kun je die waarden lezen en elk ervan bijwerken.

Voordat je begint

  • Authenticeer met je API-sleutel (zie Authenticatie).
  • Basis-URL: https://go.fliplink.me.

Je profiel lezen

GET /api/get-profile geeft het huidige profiel voor de API-sleutel terug.

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

Response:

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

Je profiel bijwerken

PUT /api/set-profile is een partiële update — elk veld dat je weglaat, behoudt zijn bestaande waarde, en je moet minstens één veld meesturen. De body is form-urlencoded.

VeldWat het instelt
NameWeergavenaam
PhoneTelefoonnummer
ProfileImageURL van een profielafbeelding
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'

Response:

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

Wil je maar één veld wijzigen, stuur dan alleen dat veld mee — de andere blijven ongemoeid.

Mogelijke fouten

  • Ontbrekende of ongeldige API-sleutel → HTTP 401, een kale Unauthorized-HTML-pagina — er is geen JSON-body.
  • Verkeerd gespeld body-veld → HTTP 200 met { "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }.

Gerelateerde discussies