Convalida archivio del marketplace di plugin
Verifica se un marketplace di plugin, caricato come .zip della directory del marketplace, verrebbe sincronizzato in claude.ai, senza collegarlo né archiviarlo.
Per verificare invece un repository GitHub pubblico, usa Convalida repository del marketplace di plugin.
Il report indica se marketplace.json è ben formato, quali plugin una sincronizzazione salterebbe e perché, e quali plugin verrebbero sincronizzati solo in parte, con alcuni file esclusi. Un archivio che non può essere letto come marketplace viene segnalato, non rifiutato: la risposta è un report con valid: false. Le origini dei plugin esterne al marketplace vengono recuperate in modo anonimo da GitHub, quindi un'origine privata viene segnalata come non trovata; un'origine su qualsiasi altro host non viene recuperata qui, e il report indica che verrà verificata quando il marketplace verrà effettivamente sincronizzato.
Nulla viene registrato nel feed delle attività della Compliance API.
Per un esempio pratico, consulta Convalidare il contenuto del marketplace nella guida alla Plugins API.
Credenziali accettate: una chiave API Admin con lo scope read:plugins o write:plugins; read:org_audit e read:compliance_org_data non ne concedono l'accesso.
Ogni richiesta deve includere l'header beta anthropic-beta: ce-plugins-2026-09-01. Una richiesta senza di esso restituisce 404, esattamente come se l'endpoint non esistesse. La Plugins API è in beta ed è disponibile solo per le organizzazioni Claude Enterprise. Non è disponibile per le organizzazioni Claude Platform (Claude Console), né per le organizzazioni con la predisposizione HIPAA abilitata.
Parameters
Returns
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ.get(
"ANTHROPIC_API_KEY"
), # This is the default and can be omitted
)
beta_plugin_marketplace_validation_report = (
client.beta.organization.plugin_marketplaces.validate_archive(
archive=b"Example data",
)
)
print(beta_plugin_marketplace_validation_report.valid){
"commit_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
"manifest_error": "manifest_error",
"manifest_error_code": "marketplace_sync_manifest_not_found",
"plugin_errors": [
{
"error": "error",
"error_code": "marketplace_sync_plugin_missing_manifest",
"name": "name"
}
],
"plugin_warnings": [
{
"name": "name",
"warnings": [
{
"error_code": "marketplace_sync_zipball_symlink_dangling",
"message": "message"
}
]
}
],
"ref": "main",
"total_plugin_count": 0,
"type": "plugin_marketplace_validation_report",
"valid": false
}Returns Examples
{
"commit_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
"manifest_error": "manifest_error",
"manifest_error_code": "marketplace_sync_manifest_not_found",
"plugin_errors": [
{
"error": "error",
"error_code": "marketplace_sync_plugin_missing_manifest",
"name": "name"
}
],
"plugin_warnings": [
{
"name": "name",
"warnings": [
{
"error_code": "marketplace_sync_zipball_symlink_dangling",
"message": "message"
}
]
}
],
"ref": "main",
"total_plugin_count": 0,
"type": "plugin_marketplace_validation_report",
"valid": false
}