{"openapi":"3.1.0","info":{"title":"SitePerto — consulta do site autorizado","version":"2.0.0","description":"Contrato de consulta do conector OAuth. Para preparar atualizações use o MCP documentado no guia. Acesso limitado ao site escolhido pela pessoa; publicação permanece no painel."},"servers":[{"url":"https://api.storeexperts.com.br"}],"externalDocs":{"url":"https://siteperto.com/guias/conectar-ia-local"},"security":[{"siteOAuth":["site.read"]}],"paths":{"/connect/v2/site":{"get":{"operationId":"getAuthorizedSite","summary":"Consultar o site autorizado","description":"Envie o token no cabeçalho Authorization: Bearer. Use resource=https://api.storeexperts.com.br/mcp ao autorizar e obter tokens. Nunca envie tokens na URL.","responses":{"200":{"description":"Contexto do site, permissões, revisão atual e link de revisão no painel.","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"const":true},"data":{"type":"object","required":["project","scopes","reviewUrl"],"properties":{"project":{"type":"object"},"scopes":{"type":"array","items":{"type":"string"}},"expiresAt":{"type":"string","format":"date-time"},"reviewUrl":{"type":"string","format":"uri"},"currentVersion":{"type":["object","null"]}}}}}}}},"401":{"description":"Token ausente, expirado ou revogado. Descubra OAuth pelo cabeçalho WWW-Authenticate.","headers":{"WWW-Authenticate":{"schema":{"type":"string"}}}},"403":{"description":"A conexão não permite acesso ao recurso solicitado."},"429":{"description":"Limite de solicitações. Aguarde antes de tentar novamente."}}}}},"components":{"securitySchemes":{"siteOAuth":{"type":"oauth2","description":"Cliente público com Authorization Code e PKCE S256. Registro de cliente em /register não concede acesso: a pessoa precisa entrar, escolher um site e consentir.","flows":{"authorizationCode":{"authorizationUrl":"https://api.storeexperts.com.br/authorize","tokenUrl":"https://api.storeexperts.com.br/token","refreshUrl":"https://api.storeexperts.com.br/token","scopes":{"site.read":"Consultar o site autorizado e seus arquivos públicos."}}}}}}}