دليل دمج Open API لمنصة Xiaohongshu / RedNote notes

تعرّف على تحليل رابط Xiaohongshu / RedNote notes عام عبر Open API من TapSave ومعالجة موارد الوسائط التي يعيدها التطبيق.

مسار التكامل

أرسل طلب POST إلى https://api.videotool.cc/openapi/parse مع Content-Type: application/json ورأس X-API-Key وحقل url للرابط العام داخل JSON.

معالجة الاستجابة

تحقق أولاً من code === 200 وdata.resultCode === 0 وdata.hasResource === true. ثم عالج مصفوفات الموارد التي أعادتها هذه الاستجابة فقط؛ لا تنشئ عناوين URL ولا تفترض تنسيقاً ثابتاً.

Xiaohongshu / RedNote notes resources

قد تتضمن ملاحظات Xiaohongshu حزم صور وفيديو ونصاً؛ تعامل مع imgList وvideoList وdescList بشكل مستقل. وعند توفرها من المصدر، تعيد الواجهة أيضاً author (اسم الكاتب) وpublishTime (وقت النشر بالتنسيق yyyy-MM-dd HH:mm:ss) وpublishTimestamp (طابع زمني للنشر بالثواني). قد تكون هذه الحقول فارغة، بينما يبقى descList دون تغيير للتوافق.

القيود والأمان

احتفظ بمفتاح API على الخادم ولا تعرضه في المتصفح. يجب التعامل مع الروابط الخاصة أو المحذوفة أو المقيّدة أو غير المتاحة كأخطاء تحليل متوقعة.