# GET /v1/me

عرض ملفي الشخصي

الملف الشخصي للمستخدم المسجل دخوله (والناشر). يتطلب طرفًا من نوع مستخدم (مفتاح API لمستخدم أو جلسة ويب). تستخدم GET وHEAD فئة حد المعدل `me`: 600 طلب في الدقيقة لكل مستخدم، تتشاركها جلسات الويب ومفاتيح API للمستخدم. تحتفظ بقية عمليات القراءة وعمليات كتابة الملف الشخصي بفئات حد المعدل الخاصة بها.

- الصلاحية المطلوبة: أي مفتاح أو جلسة موثقة
- حد المعدل: `me` — 600 طلبًا لكل نافذة مدتها 60 ثانية لكل مستخدم، تتشاركه جلسات الويب ومفاتيح API للمستخدم

## المعاملات

لا معاملات.

## الاستجابة

```
{ email: string; id: integer; locale: "en" | "vi" | "es" | "pt" | "fr" | "id" | "ru" | "zh" | "ar"; mfa_enabled: boolean; publisher: { display_name: string; id: integer; min_payout: string; payout_details_masked: string | null; payout_method: "paypal" | "usdt" | "bank" | null; payout_method_pending: { effective_at: string; masked: string; method: "paypal" | "usdt" | "bank"; requested_at: string } | null; permissions: { auto_approve_sites: boolean; direct_link: boolean; manage: boolean }; revshare_pct: number; status: "active" | "pending" | "suspended" } | null; role: "admin" | "publisher" | "advertiser"; security_notice: { at: string; kind: "mfa_enabled" | "mfa_disabled" | "mfa_reset_by_admin" | "recovery_regenerated" | "recovery_used" | "password_changed" | "login_new_device" | "session_revoked" | "payout_method_requested" | "payout_method_applied" | "payout_method_cancelled" | "telegram_linked" | "telegram_unlinked" | "telegram_payout_enabled" | "telegram_payout_disabled" } | null; timezone: string; view_as: { display_name: string; publisher_id: integer } | null }
```

## الأخطاء

تعيد المسارات الخاضعة لحد المعدل الترويسات `RateLimit-Limit` و`RateLimit-Remaining` و`RateLimit-Reset` (عدد الثواني حتى انتهاء النافذة)؛ وتحمل الاستجابة 429 أيضًا `Retry-After`. قد تغيب الترويسات أثناء عدم توفر المحدّد مؤقتًا (وتمرّر الطلبات حينئذ).

| الحالة | المعنى |
|---|---|
| 401 | مفتاح API مفقود أو غير صالح أو ملغى. |
| 403 | ينقص المفتاح الصلاحية المطلوبة، أو العملية غير مسموح بها لهذا الطرف. |
| 429 | تم تجاوز حد المعدل؛ انتظر `Retry-After` ثانية. |

وثائق HTML: https://agimone.com/ar/developers/api/#get-me
API 2026-10
