typedprovidersget
استرجاع فنون مزود مكتوبة + بيانات دورة الحياة لإصدار واحد.
ملاحظات رئيسية
- يتطلب حقول tenant_id و namespace_id.
- إرجاع عقد المزود + ملف التشغيل للإصدار المحدد.
- يمكن تقييم انحراف التجزئة مقابل التجزئات المصدر/الملف الشخصي الملاحظة.
- إذا تم حذف الإصدار، يتم اختيار الإصدار النشط.
مدخلات
- namespace_id (مطلوب): معرف مساحة الاسم.
observed_profile_digest(اختياري): ملاحظة اختياري لملخص الملف الشخصي لفحوصات الانجراف.observed_source_digest(اختياري): ملاحظة اختياري لمصدر التجزئة لمراقبة الانجراف.provider_id(مطلوب): معرف المزود المكتوب.- tenant_id (مطلوب): معرف المستأجر.
version(اختياري): واحدة من نسختين من المخطط.
مخطط الإدخال
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"namespace_id": {
"description": "Namespace identifier.",
"minimum": 1,
"type": "integer"
},
"observed_profile_digest": {
"description": "Optional profile digest observation for drift checks.",
"oneOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"algorithm": {
"enum": [
"sha256"
],
"type": "string"
},
"value": {
"description": "Lowercase hex digest.",
"type": "string"
}
},
"required": [
"algorithm",
"value"
],
"type": "object"
}
]
},
"observed_source_digest": {
"description": "Optional source digest observation for drift checks.",
"oneOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"algorithm": {
"enum": [
"sha256"
],
"type": "string"
},
"value": {
"description": "Lowercase hex digest.",
"type": "string"
}
},
"required": [
"algorithm",
"value"
],
"type": "object"
}
]
},
"provider_id": {
"description": "Typed provider identifier.",
"type": "string"
},
"tenant_id": {
"description": "Tenant identifier.",
"minimum": 1,
"type": "integer"
},
"version": {
"oneOf": [
{
"type": "null"
},
{
"description": "Lifecycle version identifier.",
"type": "string"
}
]
}
},
"required": [
"tenant_id",
"namespace_id",
"provider_id"
],
"type": "object"
}
المخرجات
active_version(مطلوب): واحدة من نسختين من المخطط.catalog_version(مطلوب): إصدار مخطط دورة حياة الكتالوج المطبوع.- عقد (مطلوب): النوع: كائن.
drift_status(مطلوب): أحد نوعي المخططين.provider_id(مطلوب): معرف المزود المكتوب.- سجل (مطلوب): النوع: كائن.
runtime_profile(مطلوب): عنصر ملف تعريف وقت التشغيل المخصص.selected_version(مطلوب): إصدار دورة الحياة المحدد.source(مطلوب): كيفية تسجيل العناصر المكتوبة.
مخطط الإخراج
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_version": {
"oneOf": [
{
"type": "null"
},
{
"description": "Current active lifecycle version.",
"type": "string"
}
]
},
"catalog_version": {
"description": "Typed lifecycle catalog schema version.",
"type": "string"
},
"contract": {
"additionalProperties": false,
"properties": {
"checks": {
"items": {
"additionalProperties": false,
"properties": {
"allowed_comparators": {
"description": "Comparator allow-list for this check.",
"items": {
"description": "Comparator applied to evidence values.",
"enum": [
"equals",
"not_equals",
"greater_than",
"greater_than_or_equal",
"less_than",
"less_than_or_equal",
"lex_greater_than",
"lex_greater_than_or_equal",
"lex_less_than",
"lex_less_than_or_equal",
"contains",
"in_set",
"deep_equals",
"deep_not_equals",
"exists",
"not_exists"
],
"type": "string"
},
"type": "array"
},
"anchor_types": {
"description": "Anchor types emitted by this check.",
"items": {
"type": "string"
},
"type": "array"
},
"check_id": {
"description": "Check identifier.",
"type": "string"
},
"content_types": {
"description": "Content types for check output.",
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"description": "Check description.",
"type": "string"
},
"determinism": {
"description": "Determinism classification for provider checks.",
"enum": [
"deterministic",
"time_dependent",
"external"
],
"type": "string"
},
"examples": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"description": "Short example description.",
"type": "string"
},
"params": {
"description": "Example params payload.",
"type": [
"null",
"boolean",
"number",
"string",
"array",
"object"
]
},
"result": {
"description": "Example result value.",
"type": [
"null",
"boolean",
"number",
"string",
"array",
"object"
]
}
},
"required": [
"description",
"params",
"result"
],
"type": "object"
},
"type": "array"
},
"params_required": {
"description": "Whether params are required for this check.",
"type": "boolean"
},
"params_schema": {
"description": "JSON schema for check params.",
"type": [
"null",
"boolean",
"number",
"string",
"array",
"object"
]
},
"result_schema": {
"description": "JSON schema for check result values.",
"type": [
"null",
"boolean",
"number",
"string",
"array",
"object"
]
}
},
"required": [
"check_id",
"description",
"determinism",
"params_required",
"params_schema",
"result_schema",
"allowed_comparators",
"anchor_types",
"content_types",
"examples"
],
"type": "object"
},
"type": "array"
},
"config_schema": {
"description": "Provider configuration schema.",
"type": [
"null",
"boolean",
"number",
"string",
"array",
"object"
]
},
"description": {
"description": "Provider description.",
"type": "string"
},
"name": {
"description": "Provider display name.",
"type": "string"
},
"notes": {
"description": "Provider notes and guidance.",
"items": {
"type": "string"
},
"type": "array"
},
"provider_id": {
"description": "Provider identifier.",
"type": "string"
},
"transport": {
"description": "Provider transport kind.",
"enum": [
"builtin",
"mcp",
"typed"
],
"type": "string"
}
},
"required": [
"provider_id",
"name",
"description",
"transport",
"config_schema",
"checks",
"notes"
],
"type": "object"
},
"drift_status": {
"oneOf": [
{
"type": "null"
},
{
"description": "Digest drift status for observed source/profile tuples.",
"enum": [
"in_sync",
"source_digest_mismatch",
"profile_digest_mismatch",
"source_and_profile_digest_mismatch"
],
"type": "string"
}
]
},
"provider_id": {
"description": "Typed provider identifier.",
"type": "string"
},
"record": {
"additionalProperties": false,
"properties": {
"deprecated": {
"description": "Whether this lifecycle version is deprecated.",
"type": "boolean"
},
"profile_digest": {
"additionalProperties": false,
"properties": {
"algorithm": {
"enum": [
"sha256"
],
"type": "string"
},
"value": {
"description": "Lowercase hex digest.",
"type": "string"
}
},
"required": [
"algorithm",
"value"
],
"type": "object"
},
"source_digest": {
"additionalProperties": false,
"properties": {
"algorithm": {
"enum": [
"sha256"
],
"type": "string"
},
"value": {
"description": "Lowercase hex digest.",
"type": "string"
}
},
"required": [
"algorithm",
"value"
],
"type": "object"
},
"version": {
"description": "Lifecycle version identifier.",
"type": "string"
}
},
"required": [
"version",
"deprecated",
"source_digest",
"profile_digest"
],
"type": "object"
},
"runtime_profile": {
"description": "Typed runtime profile artifact.",
"type": [
"null",
"boolean",
"number",
"string",
"array",
"object"
]
},
"selected_version": {
"description": "Selected lifecycle version.",
"type": "string"
},
"source": {
"description": "How the typed artifacts were registered.",
"enum": [
"openapi_import",
"artifact_register"
],
"type": "string"
}
},
"required": [
"provider_id",
"catalog_version",
"active_version",
"selected_version",
"source",
"record",
"contract",
"runtime_profile",
"drift_status"
],
"type": "object"
}
أمثلة
استرجاع العناصر الفنية لمزود البيانات المدخلة وبيانات دورة الحياة.
مدخل:
{
"namespace_id": 1,
"observed_profile_digest": {
"algorithm": "sha256",
"value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
},
"observed_source_digest": {
"algorithm": "sha256",
"value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
},
"provider_id": "asset_api",
"tenant_id": 1,
"version": "2026-02-17.1"
}
Output:
{
"active_version": "2026-02-17.1",
"catalog_version": "typed-lifecycle-v1",
"contract": {
"checks": [],
"config_schema": {
"additionalProperties": false,
"type": "object"
},
"description": "Typed API provider",
"name": "Asset API",
"notes": [],
"provider_id": "asset_api",
"transport": "typed"
},
"drift_status": "in_sync",
"provider_id": "asset_api",
"record": {
"deprecated": false,
"profile_digest": {
"algorithm": "sha256",
"value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
},
"source_digest": {
"algorithm": "sha256",
"value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
},
"version": "2026-02-17.1"
},
"runtime_profile": {
"anchors": {
"anchor_type": "typed_request"
},
"operations": [
{
"allowed_status_codes": [
200
],
"auth": {
"alternatives": [
{
"kind": "none"
}
]
},
"bindings": [],
"check_id": "listAssets",
"content_types": [
"application/json"
],
"extraction": {
"kind": "json_body"
},
"method": "GET",
"operation_id": "listAssets",
"target": "https://api.example.com/assets"
}
],
"profile_digest": {
"algorithm": "sha256",
"value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
},
"profile_version": "typed-runtime-v4",
"protocol": "openapi_http",
"provider_id": "asset_api",
"security": {
"allow_http": false,
"allow_private_networks": false,
"allowed_hosts": null,
"max_response_bytes": 1048576,
"outbound_max_inflight": 32,
"retry": {
"initial_backoff_ms": 100,
"max_attempts": 3,
"max_backoff_ms": 2000
},
"timeout_ms": 5000
},
"source_digest": {
"algorithm": "sha256",
"value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
}
},
"selected_version": "2026-02-17.1",
"source": "openapi_import"
}