واجهة Sağlama البرمجية (API)

• GET/api/v1/hisse/{kod}السجل الحالي لشركة واحدة: النسب الثلاث والعتبات والحالة ومقارنة الإقرار ومراجع المصادر.
• GET/api/v1/hisse/{kod}/tarihceسجلات الفترات في وقتها: يُحفظ كل سطر بالمعلومات المتاحة يومها، وتُضاف التصحيحات سطورًا منفصلة.
• GET/api/v1/listeقائمة الشركات: حالة المؤشر الرسمية وقياس Sağlama، مع معاملات التصفية.
• GET/api/v1/sapmaالشركات التي تختلف فيها القائمة الرسمية عن الحساب المستقل، مع الفترة؛ وتُدرج حالات «فوق العتبة بالدليل» وحالات «يتوقف على إقرار الشركة» في قائمتين منفصلتين.
• GET/api/v1/cagriتوقعات المراجعة الدورية: التوقع لكل عضو قبل المراجعة التالية (يبقى، ضمن هامش السماح، يُتوقع خروجه، بانتظار الإقرار)، مع السبب والإقرار ونطاق القياس، وتقييد النتيجة بعد الإعلان.

صيغة الاستجابة: JSON بترميز UTF-8. أسماء الحقول بالتركية ومطابقة لعقد التصدير. في كتل النسب، الحقل value_pct هو الحد الأعلى الاحتياطي، والحقل lower_pct هو الحد الأدنى المُثبت من القوائم المالية وإيضاحاتها، والحقل certainty قيمته kesin أو beyana_bagli أو okuma_bekliyor. وإذا كانت قيمة okuma_tam هي false فقراءة القوائم لهذه النسبة غير مكتملة: تستند النسبة إلى البنود المقروءة، ولا تُعدّ حدًّا، ولا تكون قيمة certainty هي kesin. قاموس الحالات: uygun وyakin وdegil وbeyana_bagli.

أسماء الحقول وبنيتها مأخوذة من عقد التصدير، والقيم في المثال للتوضيح.

{
  "ticker": "ORNMK",
  "name": "Örnek Makina Sanayi ve Ticaret A.Ş.",
  "official": { "in_katilim_tum": true, "indices": ["XKTUM", "XK100"],
                "as_of": "2026-07-17", "source": "bist_csv" },
  "olcum": {
    "status": "uygun",
    "period": "2025/12",
    "computed_at": "2026-05-13",
    "method_version": "tkbb_current@2025-08.v3",
    "ratios": {
      "borc":   { "value_pct": 21.4, "threshold_pct": 33, "grace_pct": 36.3 },
      "varlik": { "value_pct":  9.8, "threshold_pct": 33, "grace_pct": 36.3 },
      "gelir":  { "value_pct":  1.9, "lower_pct": 0.4, "upper_pct": 1.9,
                  "certainty": "kesin", "okuma_tam": true, "threshold_pct": 5, "grace_pct": 5.5 }
    },
    "sources": [
      { "label": "2025 yıllık finansal rapor (şirket İR)",
        "url": "https://…", "sha256": "…", "date": "2026-03-06" }
    ]
  },
  "beyan": { "gelir_pct": 1.9, "varlik_pct": 9.8, "borc_pct": 21.4,
             "period": "2025/12" }
}

تاريخ الحساب 13 مايو 2026 · المنهجية tkbb_current@2025-08.v2