API e Swagger

Questa sezione raccoglie i contratti API pubblicati su Smart Repository. La UI Swagger resta centralizzata, mentre ogni prodotto mantiene il proprio contratto OpenAPI in formato YAML e JSON.

Il catalogo della conoscenza non appartiene al repository software. I manifest versionati usati dalla AI sono pubblicati dalla KnowledgePack API e dal relativo endpoint runtime https://kb.smartecommerce.it/v1/packs.

Catalogo centrale

• Indice Swagger prodotti
• Swagger UI centrale
• Indice machine-readable

Prodotti disponibili

Prodotto	Tipo	Swagger	YAML	JSON
Smart Bootstrap Manager	Plugin	Apri	YAML	JSON
Smart Site Login Personalize	Plugin	Apri	YAML	JSON
AI-HTML	Tema	Apri	YAML	JSON
1oT Daily Platform	App	Apri	YAML	JSON

Test verso un sito target

La Swagger UI centrale accetta due parametri:

url=/api-docs/{tipo}/{slug}/openapi.yaml
server=https://dominio.it

Esempio:

https://repository.smartecommerce.it/swagger/?url=/api-docs/plugins/smart-bootstrap-manager/openapi.yaml&server=https://dy22.it

Se server non termina con /wp-json, la UI lo normalizza automaticamente.

Standard per nuovi prodotti

Ogni nuovo plugin, tema o applicazione deve pubblicare:

• https://repository.smartecommerce.it/api-docs/{tipo}/{slug}/openapi.yaml
• https://repository.smartecommerce.it/api-docs/{tipo}/{slug}/openapi.json
• https://repository.smartecommerce.it/swagger/{slug}/

Il prodotto deve essere registrato anche in:

https://repository.smartecommerce.it/api-docs/index.json

Per plugin e temi WordPress, il manifest update deve includere:

{
  "documentation_url": "https://repository.smartecommerce.it/swagger/{slug}/",
  "openapi_yaml": "https://repository.smartecommerce.it/api-docs/{tipo}/{slug}/openapi.yaml",
  "openapi_json": "https://repository.smartecommerce.it/api-docs/{tipo}/{slug}/openapi.json"
}