Skip to main content
API Explorer|API Explorer
Infrastructure/Assets
POSTAssetLinkSince 1.1.0SynchronousAuth Required

PrecheckAssetLink

Run asset-link matching logic without persisting links or audit records.

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Request Inputs

Body Fields

  • productTypeStringRequired

    Reserved for a future create-before-persist precheck flow. Not supported in beta; use platform_uuid instead.

    Example: value

  • hostIpStringRequired

    Reserved for a future create-before-persist precheck flow. Not supported in beta; use platform_uuid instead.

    Example: value

  • hostPortIntegerRequired

    Reserved for a future create-before-persist precheck flow. Not supported in beta; use platform_uuid instead.

    Example: 10

  • usernameStringRequired

    Reserved for a future create-before-persist precheck flow. Not supported in beta; use platform_uuid instead.

    Example: value

  • passwordStringRequired

    Reserved for a future create-before-persist precheck flow. Not supported in beta; use platform_uuid instead.

    Example: value

Responses

200 OK

On success, this API returns the following response structure.

  • itemsList

    Collection of result items

    Example: (nested array)

    • linkObject

      链接。

      • uuidString

        Unique identifier of the asset link

        Example: link-uuid

      • regionUuidString

        Region uuid for this resource

        Example: value

      • sourcePlatformUuidString

        Source platform uuid for this resource

        Example: value

      • sourceAssetTypeString

        Source asset type for this resource

        Example: value

      • sourceAssetUuidString

        Source asset uuid for this resource

        Example: value

      • sourceAssetNameString

        Source asset name for this resource

        Example: value

      • targetPlatformUuidString

        Target platform uuid for this resource

        Example: value

      • targetAssetTypeString

        Target asset type for this resource

        Example: value

      • targetAssetUuidString

        Target asset uuid for this resource

        Example: value

      • targetAssetNameString

        Target asset name for this resource

        Example: value

      • linkTypeString

        Link type for this resource

        Example: value

      • matchMethodString

        Match method for this resource

        Example: value

      • confidenceLong

        Confidence score of the current asset-link match

        Example: 0.95

      • statusString

        Status for this resource

        Example: value

      • sourceDetectionString

        Source detection for this resource

        Example: value

      • matchFieldsString

        Match fields for this resource

        Example: value

      • candidateSetString

        Candidate set for this resource

        Example: value

      • statusReasonString

        Status reason for this resource

        Example: value

      • displayHintString

        Display hint for this resource

        Example: value

      • lastDetectedAtString

        Last detected at for this resource

        Example: 2026-01-15T08:00:00Z

      • createDateString

        Create date for this resource

        Example: 2026-01-15T08:00:00Z

      • lastOpDateString

        Last op date for this resource

        Example: 2026-01-15T08:00:00Z

    • auditActionString

      Audit action for this resource

      Example: value

    • auditDetailString

      Audit detail for this resource

      Example: value

  • totalInteger

    Total for this resource

    Example: 10

  • limitInteger

    Limit for this resource

    Example: 10

  • offsetInteger

    Offset for this resource

    Example: 10

  • blockingBoolean

    Whether precheck found a blocking condition that prevents proceeding

    Example: false

  • blockingReasonString

    Blocking reason for this resource

    Example: value

  • modeString

    Precheck execution mode returned by the server

    Example: post_create_only

Endpoint

POST/api/v1/asset-links/precheck

/api/v1/asset-links/precheck

Operation ID

PrecheckAssetLink

Permalink

Request Example

curl -X POST '{host}/api/v1/asset-links/precheck' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"platformUuid":"zaku-platform-uuid"}'

Response Example

200
{"items": [{"link": {"uuid": "link-uuid", "regionUuid": "value", "sourcePlatformUuid": "value", "sourceAssetType": "value", "sourceAssetUuid": "value", "sourceAssetName": "value", "targetPlatformUuid": "value", "targetAssetType": "value"}, "auditAction": "value", "auditDetail": "value"}], "total": 10, "limit": 10, "offset": 10, "blocking": false, "blockingReason": "value", "mode": "post_create_only"}

Change History

This API has no change history records yet.

View all change history