واجهة API لرمي النرد العشوائي بصيغة JSON

تتيح API من DéJeté إضافة مولد نرد عشوائي إلى موقع أو لعبة أو نموذج أولي أو سكربت من دون بناء واجهة رمي جديدة.

تتضمن الاستجابة نتيجة كل حجر نرد بصيغة JSON لتتم معالجتها على الخادم أو داخل تطبيقك.

معاملات API وطريقة طلب رمية النرد

لاستدعاء الواجهة، أرسل طلب GET يتضمن عدد أحجار النرد وعدد الأوجه المطلوبة كما في المثال أدناه.

مثال على الاستدعاء: https://www.dejete.com/api?nbde=5&tpde=6

يشير المتغير « nbde » إلى عدد أحجار النرد، بينما يشير « tpde » إلى عدد أوجه كل حجر. في هذا المثال يتم رمي 5 أحجار نرد ذات 6 أوجه.

قراءة نتائج الرمي واستخدام JSON

يعيد طلب GET استجابة بصيغة JSON. بعد ذلك يكفي فك ترميزها لاستخدام النتائج في السكربت أو البرنامج.

مثال على الدمج بلغة PHP:

<?php
     $resultat = file_get_contents('https://www.dejete.com/api?nbde=5&tpde=6');
     $json = json_decode($resultat);
     foreach($json as $de)
     {
          echo $de->id.' : '.$de->value.'<br>';
     }
?>

تتضمن كل نتيجة حقلي JSON « id » و« value »: يعرّف « id » حجر النرد، بينما تتضمن « value » القيمة العشوائية الناتجة.

متى تستخدم API النرد من DéJeté؟

تناسب API النماذج الأولية للألعاب والأدوات التعليمية والعمليات البسيطة التي تحتاج إلى رميات رقمية. وقبل الدمج يمكنك اختبار السلوك بصرياً عبر محاكي النرد أونلاين أو صفحة نرد RPG من d4 إلى d100.