SDK أولاً من جانب الخادم
استخدم @image2url/next لقبول الملفات في معالجات المسارات أو مسارات API، ادفعها إلى image2url، وشحن روابط التخزين المؤقت CDN في مكالمة واحدة. مبني للسرعة وقابلية الرصد وعدم وجود عمليات تضمين معطوبة.
استراتيجية التخزين المؤقت
public, max-age=31536000
التحقق
MIME + حارس الحجم
التنسيقات
URL + Markdown/HTML/BBCode
import { uploadImage } from '@image2url/next';
import { NextResponse } from 'next/server';
export async function POST(request: Request) {
const form = await request.formData();
const file = form.get('file');
if (!(file instanceof File)) {
return NextResponse.json({ error: 'ملف مفقود' }, { status: 400 });
}
const result = await uploadImage({
file,
alt: 'hero-banner',
endpoint: 'https://www.image2url.com/api/upload',
});
return NextResponse.json(result);
}آمن بشكل افتراضي
رفع HTTPS، التحقق من MIME، حدود الحجم، وتشفير أسماء الملفات. إرجاع أخطاء منظمة يمكنك تسجيلها.
روابط صديقة لـ SEO
عناوين URL مستقرة لـ CDN مع رؤوس التخزين المؤقت وسلاسل استخدام صديقة لـ alt للمدونات والوثائق والتضمينات.
مخرجات محددة
URL بالإضافة إلى سلاسل Markdown و HTML و BBCode، بالإضافة إلى حقول filename و mimeType و size و uploadedAt.
رفع أولاً من جانب الخادم
احتفظ بالرموز من جانب الخادم، دفق الملفات في معالجات المسارات، وتجنب تسريب البيانات إلى العميل.
قابلية الرصد مدمجة
JSON متسق للتسجيل والتحليلات. أضف محاولاتك الخاصة أو المراقبة عن بعد دون تخمين أشكال الاستجابة.
احتياطي صديق للحافة
يعمل في وقت تشغيل node ويتدهور بأمان في الحافة. قم بتكوين نقاط النهاية لكل بيئة.
تخزين مؤقت يمكنك الوثوق به
رؤوس تخزين مؤقت عامة وطويلة الأمد على المخرجات. مثالي للوثائق ومواقع التسويق والعروض الثابتة.
خارطة طريق مفتوحة المصدر
نشحن في العلن. ساعدنا في إضافة عناوين URL موقعة وتحولات الصور والإعدادات المسبقة للإطار.
ترحيل بديل مباشر
ابدل مساعد الرفع الخاص بك بمكالمة واحدة؛ احتفظ بالنماذج وواجهة المستخدم دون تغيير.
نحن نجمع أنماط العالم الحقيقي: الرفع الموقوع، النطاقات المخصصة لـ CDN، أمثلة برمجيات Next.js الوسيطة، وتحسينات DX. النجوم والمشاكل و PRs على GitHub تحافظ على صحة المشروع.
تفضل React hooks؟ جرب @image2url/react. تحتاج إلى تدفقات الوكلاء؟ استخدم mcp-server-image2url.
ماذا يحل @image2url/next؟
يحتفظ بالرفع من جانب الخادم في Next.js (معالجات المسارات أو مسارات API)، يرجع JSON موثوق، ويشحن عناوين URL جاهزة لـ CDN مع مقتطفات Markdown/HTML.
هل أحتاج مفاتيح API؟
نقطة النهاية الافتراضية على image2url.com تقدم حصة مجانية قائمة على IP. يمكن للنشرات المستضافة ذاتيًا فرض الرموز وحدود الحجم المخصصة.
هل هو متوافق مع الحافة؟
نعم. المساعد يعمل في معالجات المسارات ويدعم الهيئات المتدفقة. يعمل بشكل أفضل في أوقات تشغيل node ولكنه يتدهور بأمان.
هل يمكنني المساهمة؟
بالتأكيد. نبني علنًا في github.com/image2url/image2url-sdk. المشاكل و PRs وتحسينات الوثائق مرحب بها.
ما هي الاستجابات التي أحصل عليها؟
URL دائم بالإضافة إلى filename و mimeType و size و uploadedAt والسلاسل المنسقة (Markdown و HTML و BBCode) للصق الفوري.
كيف يتم التعامل مع الموثوقية؟
الرفع هو HTTPS، يتم التحقق من MIME والحجم، يضبط Cache-Control: public, max-age=31536000، ويرجع أخطاء منظمة يمكنك تسجيلها.
جاهز للشحن
عناوين URL مدعومة من CDN واستجابات موثوقة وخارطة طريق مدفوعة بالمجتمع.