API Docs

v1

وثائق API الخاصة بـ PasteAR. استخدم الـ API للتكامل مع تطبيقاتك.

المصادقة

جميع الطلبات تتطلب مفتاح API في الـ header:

Authorization: Bearer YOUR_API_KEY

يمكنك الحصول على مفتاح API من إعدادات حسابك.

نقاط الوصول

GET/v1/pastes
POST/v1/pastes
GET/v1/pastes/:id
PUT/v1/pastes/:id
DELETE/v1/pastes/:id
GET/v1/groups
POST/v1/groups
POST/v1/upload/presign

مثال عملي

POST/v1/pastes
curl -X POST https://api.pastear.com/v1/pastes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "ملاحظة سريعة",
    "content": "محتوى النسخة هنا",
    "visibility": "private",
    "group_id": "optional-group-id"
  }'
الاستجابة:
{
  "id": "paste_abc123",
  "title": "ملاحظة سريعة",
  "slug": "paste-abc123",
  "visibility": "private",
  "created_at": "2024-10-24T12:00:00Z"
}

رموز الخطأ

400طلب غير صالح — تحقق من البيانات المرسلة
401غير مصرح — مفتاح API غير صالح أو منتهي
403ممنوع — ليس لديك صلاحية لهذا المورد
404غير موجود — المورد المطلوب غير متوفر
429كثرة الطلبات — تم تجاوز حد الاستخدام
500خطأ في الخادم — حاول مرة أخرى لاحقاً

حدود الاستخدام

100
طلب / دقيقة (Free)
500
طلب / دقيقة (Plus)
2000
طلب / دقيقة (Pro)