واجهة برمجية لأكواد QR والروابط يحبّها نظامك الخلفي.
مصادقة برمز Bearer، أخطاء بمعيار RFC 7807، خاصية Idempotency على كل طلب POST، Webhooks موقَّعة، ومواصفة OpenAPI معروضة على /docs. مبنية لتتكامل معها أكثر من 100 منتج دون احتكاك تشغيلي.
١. أنشئ مفتاح API
افتح الإعدادات ← مفاتيح API، امنحه اسماً، اختر النطاقات (مثل links:write)، وانسخ السر مرة واحدة.
qrf_live_aB3kQ9m...٢. صادِق
أرسل المفتاح كرمز Bearer. حدود المعدل لكل مفتاح وقوائم عناوين IP المسموح بها تُفرَض من جهة الخادم.
Authorization: Bearer qrf_live_aB3kQ9m...
Idempotency-Key: 8a72b9e0-...٣. أنشئ رابطاً ديناميكياً
curl -X POST https://api.qrindo.com/api/v1/links \
-H "Authorization: Bearer $QRINDO_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"target_url": "https://example.com/spring-sale",
"title": "Spring Sale 2026"
}'٤. اشترك في أحداث المسح
POST /api/v1/webhooks
{
"url": "https://yourapp.com/hooks/qrindo",
"events": ["scan.created", "link.updated"]
}
# Verify signature on receive (Stripe-style):
# Qrindo-Signature: t=...,v1=hex(hmac_sha256(secret, t + "." + body))ثلاث طرق للمصادقة، ونموذج ذهني واحد
مفاتيح API — موصى بها
طويلة الأمد، محدودة النطاق لكل مساحة عمل. الصقها في بيئة نظامك الخلفي. الأفضل لتسعين بالمئة من الحالات.
OAuth 2.0 ببيانات اعتماد العميل
رموز JWT قصيرة الأمد، ومفاتيح توقيع تُدوَّر عبر JWKS، يسهل إدراجها في مراجعات الامتثال.
OAuth 2.0 مع PKCE — عند الطلب
لشركاء SaaS الذين يريدون التصرف نيابةً عن مستخدم Qrindo. راسلنا للبدء.
حِزم SDK وخادم MCP
واجهة REST متاحة اليوم. حزمة SDK للتايب‑سكربت من الدرجة الأولى قيد المعاينة (تليها Python و Kotlin)، وخادم MCP — ليتمكّن مساعدو الذكاء الاصطناعي مثل Claude من إنشاء روابطك وإعادة توجيهها وتحليلها بمفتاح API — قيد التطوير. وإلى أن تصدر الحِزم وخادم MCP على npm، نادِ الواجهة مباشرةً:
curl https://api.qrindo.com/api/v1/links \
-H "Authorization: Bearer $QRINDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target_url":"https://example.com"}'