Add scoped private business verification evidence and expiry
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
"openapi": "3.1.0",
|
||||
"info": {
|
||||
"title": "InvestMoz — private existing-business intake",
|
||||
"version": "1.0.0",
|
||||
"version": "1.1.0",
|
||||
"description": "Internal preparation and review only. No publication, certification, legal transfer, NDA, payment or external CRM operation."
|
||||
},
|
||||
"servers": [
|
||||
@@ -320,6 +320,90 @@
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"verifications": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"version_no",
|
||||
"check",
|
||||
"outcome",
|
||||
"evidence_reference",
|
||||
"note"
|
||||
],
|
||||
"properties": {
|
||||
"version_no": {
|
||||
"type": "integer",
|
||||
"minimum": 1
|
||||
},
|
||||
"object_id": {
|
||||
"type": [
|
||||
"string",
|
||||
"null"
|
||||
],
|
||||
"format": "uuid"
|
||||
},
|
||||
"check": {
|
||||
"enum": [
|
||||
"identity",
|
||||
"representation",
|
||||
"declared_ownership",
|
||||
"documentary_ownership",
|
||||
"document_received",
|
||||
"document_validated",
|
||||
"independent_valuation",
|
||||
"land_right_documented",
|
||||
"license_confirmed",
|
||||
"validity",
|
||||
"legal_transfer",
|
||||
"prior_authorization"
|
||||
]
|
||||
},
|
||||
"outcome": {
|
||||
"enum": [
|
||||
"confirmed",
|
||||
"rejected",
|
||||
"inconclusive",
|
||||
"revoked"
|
||||
]
|
||||
},
|
||||
"evidence_reference": {
|
||||
"type": "string",
|
||||
"minLength": 10,
|
||||
"maxLength": 2000
|
||||
},
|
||||
"note": {
|
||||
"type": "string",
|
||||
"minLength": 10,
|
||||
"maxLength": 2000
|
||||
},
|
||||
"valid_until": {
|
||||
"type": [
|
||||
"string",
|
||||
"null"
|
||||
],
|
||||
"format": "date",
|
||||
"description": "Required for confirmed findings; must be today or later."
|
||||
},
|
||||
"effective_outcome": {
|
||||
"enum": [
|
||||
"confirmed",
|
||||
"rejected",
|
||||
"inconclusive",
|
||||
"revoked",
|
||||
"stale",
|
||||
"expired"
|
||||
]
|
||||
},
|
||||
"content_version": {
|
||||
"type": "integer"
|
||||
},
|
||||
"created_at": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1088,6 +1172,130 @@
|
||||
},
|
||||
"description": "Session authentication and Laravel CSRF/origin protection apply. Use X-XSRF-TOKEN for browser clients."
|
||||
}
|
||||
},
|
||||
"/listings/{id}/verifications": {
|
||||
"post": {
|
||||
"summary": "Record independent finding while in_review; immutable encrypted evidence, optimistic version and scoped object. Does not publish or certify the business.",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "id",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "uuid"
|
||||
}
|
||||
}
|
||||
],
|
||||
"security": [
|
||||
{
|
||||
"session": []
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "Private response; Cache-Control private, no-store",
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/Business"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"401": {
|
||||
"description": "Authentication required"
|
||||
},
|
||||
"403": {
|
||||
"description": "Account, ownership or current reviewer/MFA policy rejected"
|
||||
},
|
||||
"404": {
|
||||
"description": "Module disabled or resource unavailable"
|
||||
},
|
||||
"409": {
|
||||
"description": "Stale version or invalid transition"
|
||||
},
|
||||
"422": {
|
||||
"description": "Validation error"
|
||||
},
|
||||
"429": {
|
||||
"description": "Rate limited"
|
||||
}
|
||||
},
|
||||
"requestBody": {
|
||||
"required": true,
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"required": [
|
||||
"version_no",
|
||||
"check",
|
||||
"outcome",
|
||||
"evidence_reference",
|
||||
"note"
|
||||
],
|
||||
"properties": {
|
||||
"version_no": {
|
||||
"type": "integer",
|
||||
"minimum": 1
|
||||
},
|
||||
"object_id": {
|
||||
"type": [
|
||||
"string",
|
||||
"null"
|
||||
],
|
||||
"format": "uuid"
|
||||
},
|
||||
"check": {
|
||||
"enum": [
|
||||
"identity",
|
||||
"representation",
|
||||
"declared_ownership",
|
||||
"documentary_ownership",
|
||||
"document_received",
|
||||
"document_validated",
|
||||
"independent_valuation",
|
||||
"land_right_documented",
|
||||
"license_confirmed",
|
||||
"validity",
|
||||
"legal_transfer",
|
||||
"prior_authorization"
|
||||
]
|
||||
},
|
||||
"outcome": {
|
||||
"enum": [
|
||||
"confirmed",
|
||||
"rejected",
|
||||
"inconclusive",
|
||||
"revoked"
|
||||
]
|
||||
},
|
||||
"evidence_reference": {
|
||||
"type": "string",
|
||||
"minLength": 10,
|
||||
"maxLength": 2000
|
||||
},
|
||||
"note": {
|
||||
"type": "string",
|
||||
"minLength": 10,
|
||||
"maxLength": 2000
|
||||
},
|
||||
"valid_until": {
|
||||
"type": [
|
||||
"string",
|
||||
"null"
|
||||
],
|
||||
"format": "date",
|
||||
"description": "Required for confirmed findings; must be today or later."
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"description": "Session authentication and Laravel CSRF/origin protection apply. Use X-XSRF-TOKEN for browser clients."
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
|
||||
Reference in New Issue
Block a user