المصادقة مع FlipLink API

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

يرتبط كل استدعاء لـ FlipLink API بحساب عبر مفتاح API الخاص به. يشرح هذا الدليل كيف ترسل ذلك المفتاح في الطلب، وكيف تؤكّد الحساب الذي يخصّه المفتاح.

الرابط الأساسي

تذهب جميع طلبات الـ API إلى:

https://go.fliplink.me

إرسال مفتاح API

يمكنك مصادقة الطلب بإحدى طريقتين — وكلتاهما مقبولة:

• ترويسة X-Api-Key:

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

• ترويسة Authorization: Bearer:

curl -X GET 'https://go.fliplink.me/api/whoami' \
  -H 'Authorization: Bearer YOUR_API_KEY'

استخدم ما يناسب عميل HTTP لديك. وتستخدم بقية هذه الأدلة X-Api-Key توخّيًا للاتساق.

أكّد الحساب الذي يخصّه المفتاح

يُعيد GET /api/whoami الحساب الذي يملك المفتاح — وهو مفيد للتحقّق من أن مفتاحًا يعمل ولمعرفة الحد الأقصى لحجم الرفع في باقتك.

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

الاستجابة:

{
  "Result": "OK",
  "UserID": "10000",
  "VendorID": "20000",
  "Name": "Your Account",
  "Email": "you@example.com",
  "Brand": "Fliplink",
  "AppURL": "go.fliplink.me",
  "MaxFileSizeMB": 150
}

الحقل MaxFileSizeMB هو الحد الأقصى لحجم الرفع في باقتك بالميغابايت.

عندما تفشل المصادقة

إذا كان المفتاح مفقودًا أو غير صالح، يستجيب الـ API بـ HTTP 401 ويُعيد صفحة HTML عادية لعدم التصريح — دون أي جسم JSON. تحقّق من صحّة مفتاحك ومن إرساله في إحدى الترويستين أعلاه.

أبقِ مفتاحك خاصًا

يحدّد مفتاح API هويّة حسابك — لذا أرسِله من الشيفرة على جانب الخادم فقط. ولا تُضمّنه أبدًا في الشيفرة على جانب العميل أو المتصفّح حيث قد يقرؤه الزوّار.