استدعِ محرّك المعالجة الجغرافية نفسه الذي تستخدمه منتجات المتصفح، من أنظمتك، عبر مفتاح خاص بمنشأتك.
أرسل ترويسة `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`: معرّفا التشغيل والطلب، والأرصدة التي احتسبها هذا الاستدعاء وما تبقّى في الفترة، والبايتات الداخلة والخارجة، ونافذة الفترة نفسها. اقرأه بدل التخمين بشأن مخصصاتك.
"usage": {
"channel": "api",
"requestId": "req_…",
"runId": "run_…",
"creditsCharged": 1,
"creditsRemaining": 999,
"inputBytes": 5000,
"outputBytes": 12345,
"totalBytes": 17345,
"periodStartAt": "2026-07-01T00:00:00.000Z",
"periodEndAt": "2026-08-01T00:00:00.000Z"
}يُهيَّأ الوصول مع منشأتك: يُصدر المسؤول زوج المفاتيح، ويُنسب كل استدعاء إلى أحد أعضاء المنشأة.
اقرأ المرجع