استدعِ محرّك المعالجة الجغرافية نفسه الذي تستخدمه منتجات المتصفح، من أنظمتك، عبر مفتاح خاص بمنشأتك.
أرسل ترويسة `Idempotency-Key` مع أي طلب قد تعيد محاولته. تكرار المفتاح نفسه يعيد النتيجة الأولى بدل تشغيل الأداة — واحتساب التشغيل — مرتين.
curl -X POST "$BASE/buffer" \
-H "X-Api-Key: $KEY" -H "X-Api-Secret: $SECRET" \
-H "Idempotency-Key: order-1234-attempt-1" \
-F "[email protected]" -F "distance_m=100"تحمل كل استجابة ناجحة كائن `usage`: معرّفي التشغيل والطلب، والبايتات الداخلة والخارجة، ومخصّص المؤسسة للأداة — فئتها، وعدد التشغيلات في الفترة، ومتى تتجدّد الفترة. ويعيد GET /usage التشغيلات التي أُجريت في الفترة الحالية.
"usage": {
"channel": "api",
"requestId": "req_…",
"runId": "6710…",
"inputBytes": 5000,
"outputBytes": 12345,
"totalBytes": 17345,
"inputFileCount": 1,
"outputFileCount": 1,
"allowance": {
"tier": "pro",
"runs": 15,
"windowDays": 1,
"resetAt": "2026-08-18T00:00:00.000Z"
}
}يُهيّأ الوصول مع مؤسستك: ينشئ المدير تطبيق واجهة برمجية في مركز التحكم ويصدر زوج مفاتيحه. وتعود التشغيلات إلى المؤسسة وتُحتسب من مخصّص فئتها.
اقرأ المرجع