قراءة ملفك الشخصي وتحديثه

ما الذي يمكنك فعله

لحسابك ملف شخصي صغير — اسم معروض، ورقم هاتف، ورابط صورة للملف الشخصي. ويتيح لك الـ API قراءة هذه القيم وتحديث أيٍّ منها.

قبل أن تبدأ

• صادِق بمفتاح API الخاص بك (انظر المصادقة).
• الرابط الأساسي: https://go.fliplink.me.

اقرأ ملفك الشخصي

يُعيد GET /api/get-profile الملف الشخصي الحالي لمفتاح الـ API.

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

الاستجابة:

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

حدّث ملفك الشخصي

الاستدعاء PUT /api/set-profile هو تحديث جزئي — فأي حقل تُغفله يحتفظ بقيمته الحالية، وعليك إرسال حقل واحد على الأقل. يكون الجسم بصيغة form-urlencoded.

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'

الاستجابة:

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

لتغيير حقل واحد فقط، أرسِل ذلك الحقل وحده — وتبقى البقية دون مساس.

الأخطاء المحتملة

• مفتاح API مفقود أو غير صالح ← HTTP 401، صفحة HTML عادية لعدم التصريح — دون أي جسم JSON.
• حقل مكتوب خطأً في الجسم ← HTTP 200 مع { "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }.