@@ -1,15 +1,10 @@
|
||||
openapi: 3.1.0
|
||||
info:
|
||||
title: AI Usage Disclosure API
|
||||
<<<<<<< HEAD
|
||||
version: 2.0.0
|
||||
description: >-
|
||||
Stateless multilingual API for visible and machine-readable AI usage declarations,
|
||||
non-binding Article 50 decision support, validation and optional licensed bulk/export capabilities.
|
||||
=======
|
||||
version: 1.8.2
|
||||
description: Stateless multilingual badge, declaration and validation API with optional licensed presentation capabilities.
|
||||
>>>>>>> ec58fc30f840ce85ea06eb3d07457640a84f941c
|
||||
servers:
|
||||
- url: https://ai.example.org
|
||||
paths:
|
||||
@@ -128,15 +123,10 @@ paths:
|
||||
"403": {$ref: '#/components/responses/LicensedCapabilityRequired'}
|
||||
/v1/article50-assessment.json:
|
||||
get:
|
||||
<<<<<<< HEAD
|
||||
summary: Return non-binding technical Article 50 decision support
|
||||
description: >-
|
||||
Evaluates the factual regulatory context supplied with a declaration. The result is
|
||||
technical decision support, not legal advice or a legal determination.
|
||||
=======
|
||||
summary: Render reusable embedding artifacts from declaration query parameters
|
||||
description: Returns accessible visible HTML, a one-step HTML embed with inline JSON-LD, Markdown and the parsed JSON-LD declaration from the same core logic used by the normal generator. The optional bulk container calls this endpoint for each subject URL.
|
||||
>>>>>>> ec58fc30f840ce85ea06eb3d07457640a84f941c
|
||||
parameters:
|
||||
- {$ref: '#/components/parameters/commonMode'}
|
||||
- {$ref: '#/components/parameters/preset'}
|
||||
@@ -169,7 +159,6 @@ paths:
|
||||
application/json:
|
||||
schema:
|
||||
type: object
|
||||
<<<<<<< HEAD
|
||||
required: [assessment, title, summary, disclaimer]
|
||||
properties:
|
||||
assessment: {$ref: '#/components/schemas/Article50Assessment'}
|
||||
@@ -251,20 +240,6 @@ paths:
|
||||
description: Bulk API authentication required when configured
|
||||
"403": {$ref: '#/components/responses/LicensedCapabilityRequired'}
|
||||
"413": {description: Configured or licensed bulk limit exceeded}
|
||||
=======
|
||||
required: [declarationUrl, badgeUrl, manifestUrl, accessibleText, html, embedHtml, markdown, jsonLd]
|
||||
properties:
|
||||
subject: {type: string, format: uri}
|
||||
declarationUrl: {type: string, format: uri}
|
||||
badgeUrl: {type: string, format: uri}
|
||||
manifestUrl: {type: string, format: uri}
|
||||
accessibleText: {type: string}
|
||||
html: {type: string, description: Visible accessible disclosure markup without JSON-LD}
|
||||
embedHtml: {type: string, description: Recommended one-step embed containing the visible disclosure and inline JSON-LD}
|
||||
markdown: {type: string}
|
||||
jsonLd: {$ref: './schema/declaration.schema.json'}
|
||||
"403": {$ref: '#/components/responses/ProRequired'}
|
||||
>>>>>>> ec58fc30f840ce85ea06eb3d07457640a84f941c
|
||||
/v1/validate:
|
||||
post:
|
||||
summary: Validate an AI usage declaration
|
||||
|
||||
Reference in New Issue
Block a user