واجهة برمجة تطبيقات لتخزين وتحديث بيانات النصوص الخاصة بك بسهولة، تدعم طرق GET وPOST
قاعدة البيانات النصية عبر الإنترنت (TextDB.online) هي منصة خدمة مجانية لتخزين ومشاركة البيانات النصية. يمكن للمستخدمين تخزين وتحديث وحذف البيانات النصية من خلال واجهة API بسيطة. يمكن تنزيل واسترجاع البيانات النصية المخزنة في أي وقت.
أرسل البيانات بتنسيق application/x-www-form-urlencoded إلى api.textdb.online/update لإجراء عمليات إنشاء وتحديث وحذف بيانات النصوص. يتم دعم طلبات طرق GET و POST.
لمزيد من المعلومات التفصيلية حول الطلب، يرجى الرجوع إلى وثائق API التالية.
| API URL | https://api.textdb.online/update/ |
| طريقة الطلب | GET / POST |
| ترميز البيانات | application/x-www-form-urlencoded |
| معلمات الطلب | key: معرف النص، الطول من 6 إلى 60 حرفًا، يدعم فقط الأحرف التالية: 0-9a-zA-Z-_ value: بيانات النص، أي نص يقل عن 200000 حرف، إذا كانت القيمة فارغة، فهذا يشير إلى حذف السجل. نظرًا لعدم وجود حماية لمصادقة كلمة المرور، يُنصح باستخدام مفتاح يتم إنشاؤه عشوائيًا يتكون من 20 حرفًا أو أكثر لتقليل احتمالية التصادم وتقليل المخاطر التجارية. |
| مثال على الطلب | 【إنشاء/تحديث】https://api.textdb.online/update/?key=123456&value=hello-world 【حذف】https://api.textdb.online/update/?key=123456&value= 【قراءة】 https://textdb.online/123456 إذا كنت تستخدم طريقة GET لتحديث البيانات، فيرجى إجراء ترميز URLEncode أولاً. يُنصح باستخدام طلب طريقة POST. |
| معلمات الاستجابة | status: نتيجة معالجة الطلب، 1 للنجاح، 0 للفشل. data.key: معرف نص مخصص. data.url: عنوان URL لسجل النص، من خلاله يمكن قراءة بيانات النص. req_id: معرف طلب API. |
| مثال على الاستجابة | {
"status": 1,
"data": {
"key": "123456",
"url": "https://textdb.online/123456"
},
"req_id": "131690600e2b79b47108"
} |
| حد الطلب | لا يوجد حد لعدد مرات القراءة، ولكن العدد الإجمالي لعمليات الإنشاء والتحديث والحذف لكل عنوان IP في اليوم محدود بـ 500. |
| الاحتياطات | 1. سيتم حذف سجلات النصوص تلقائيًا بعد عام واحد من عدم وجود عمليات تحديث. يُنصح بحذفها بشكل استباقي بعد الاستخدام. 2. لا تحتوي بيانات النص على حماية بكلمة مرور للوصول. يُوصى بتعيين طول مفتاح لا يقل عن 20 حرفًا أو إضافة بادئة فريدة لتجنب المخاطر التجارية الناتجة عن اصطدام المفاتيح. 3. إنشاء البيانات أو تحديثها بطيء، يرجى تجنب العمليات المتكررة. 4. يُمنع منعاً باتاً تخزين البيانات غير القانونية أو استخدام المنصة لأغراض غير قانونية! |
إذا كان سجل النص غير موجود، فسيتم إنشاؤه تلقائيًا؛ إذا كان السجل موجودًا بالفعل، فسيتم تحديثه.
بعد الإنشاء أو التحديث، يمكن قراءة سجل النص من خلال https://textdb.online/[اسم المفتاح]، يتم دعم طلبات المصدر المتبادل افتراضيًا، ونوع المحتوى هو text/plain.
عند قراءة سجل النص، إذا كان السجل موجودًا، سيتم إرجاع رمز الحالة 200 أو 30x؛ إذا لم يكن السجل موجودًا، فسيتم إرجاع رمز الحالة 404 وصفحة HTML 404. يمكنك تحديد حالة البيانات النصية من خلال رمز حالة الاستجابة أو تنسيق المحتوى.
خدمة TextDB.online مبنية على شبكة Cloudflare، لذلك قد يكون هناك تخزين مؤقت. عند إنشاء وتحديث وحذف بيانات النص، يتم تحديث التخزين المؤقت تلقائيًا، مما قد يستغرق وقتًا. يرجى محاولة تقليل تكرار الإنشاء والتحديثات، والتركيز بشكل أساسي على القراءة.