التحقق والتحليل والصيغ المعيارية

def valid_export(value):
    return (isinstance(value, dict)
            and set(value) == {"title", "copies"}
            and isinstance(value["title"], str)
            and 1 <= len(value["title"].strip()) <= 80
            and type(value["copies"]) is int
            and 1 <= value["copies"] <= 5)

assert valid_export({"title": "Notes", "copies": 2})
assert not valid_export({"title": "Notes", "copies": True})
assert not valid_export({"title": " ", "copies": 2})

تغطي التحققات كائناً صالحاً وعدداً منطقياً مرفوضاً وعنواناً فارغاً، دون API أو ملف أو حساب أو قاعدة. هذا المتحقق الضيق ليس محللاً لكل تنسيق ويب أو نظام تفويض كاملاً.

{
  "schema": "lab-note-export-v1",
  "allowedFields": ["title", "copies"],
  "unknownFields": "reject",
  "serverOwnedFields": ["organization", "createdBy", "permission"],
  "outsideThisExample": ["transport-size", "authentication", "authorization", "output-context"]
}

JSON توثيق لا إعداد إطار؛ لا يمنح وصولاً أو يحلل طلباً. تأتي الحقول المملوكة للخادم من سياق موثوق حتى لو قدم العميل قيماً بأسماء مماثلة.