البدء السريع

1. أنشئ مفتاحًا شخصيًا

في تطبيق Sofia، افتح الإعدادات › API، تبويب الوصول الشخصي، وأنشئ مفتاحًا. اختر اسمه وتاريخ انتهائه وصلاحياته. يُعرض المفتاح مرة واحدة فقط: انسخه واحفظه في مخزن أسرار، وليس في شيفرتك أبدًا.

2. نفّذ أول استدعاء

أرسل المفتاح في الترويسة Authorization. يخبرك GET /v1/me لمن يتصرف المفتاح، ومساحات عمله وصلاحياته.

bash

curl https://api.sofia-post.com/api/v1/me \
  -H "Authorization: Bearer $SOFIA_API_KEY"

json

{
  "tokenType": "personal_key",
  "user": { "id": "cmo7qiltc0000sb1p7zdx1aw4" },
  "coverage": "account",
  "workspaces": [{ "id": "cmo7qiltc0000sb1p7zdx1aw4", "name": "160 food" }],
  "scopes": ["establishments:read", "posts:read", "posts:write"],
  "mode": "live",
  "expiresAt": "2026-11-09T20:09:05.644Z"
}

3. اعرض منشآتك

كل منشور ينتمي إلى منشأة. دوّن id الخاص بالمنشأة التي تريد النشر لها.

bash

curl https://api.sofia-post.com/api/v1/establishments \
  -H "Authorization: Bearer $SOFIA_API_KEY"

الخطوات التالية

أنت جاهز لـمنشورك الأول. لتجربة أي نقطة نهاية من متصفحك، افتح مرجع API واضغط جرّبها.