Content Calendar Analysis API

\n \n \n\n\n `;\n}\n\n// OpenAPI specification\nexport const openApiSpec = {\n openapi: \"3.0.0\",\n info: {\n title: \"Content Calendar Analysis API\",\n description: \"API for generating and managing content calendar analyses using Gemini AI\",\n version: \"1.0.0\",\n contact: {\n email: \"support@example.com\"\n }\n },\n servers: [\n {\n url: \"/api\",\n description: \"API Base URL\"\n }\n ],\n tags: [\n {\n name: \"auth\",\n description: \"Authentication operations\"\n },\n {\n name: \"analysis\",\n description: \"Content calendar analysis operations\"\n }\n ],\n paths: {\n \"/auth/register\": {\n post: {\n tags: [\"auth\"],\n summary: \"Register a new lead\",\n description: \"Create a new lead account and return a session cookie\",\n requestBody: {\n required: true,\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/LeadInput\"\n }\n }\n }\n },\n responses: {\n \"200\": {\n description: \"Registration successful\",\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n properties: {\n success: {\n type: \"boolean\",\n example: true\n },\n data: {\n type: \"object\",\n properties: {\n lead: {\n $ref: \"#/components/schemas/LeadOutput\"\n },\n message: {\n type: \"string\",\n example: \"Registration successful\"\n }\n }\n }\n }\n }\n }\n }\n },\n \"400\": {\n description: \"Invalid input\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"409\": {\n description: \"Email already registered\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"500\": {\n description: \"Server error\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n }\n }\n }\n },\n \"/auth/login\": {\n post: {\n tags: [\"auth\"],\n summary: \"Login with existing credentials\",\n description: \"Authenticate a lead and return a session cookie\",\n requestBody: {\n required: true,\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/LoginInput\"\n }\n }\n }\n },\n responses: {\n \"200\": {\n description: \"Login successful\",\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n properties: {\n success: {\n type: \"boolean\",\n example: true\n },\n data: {\n type: \"object\",\n properties: {\n lead: {\n $ref: \"#/components/schemas/LeadOutput\"\n },\n message: {\n type: \"string\",\n example: \"Login successful\"\n }\n }\n }\n }\n }\n }\n }\n },\n \"400\": {\n description: \"Invalid input\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"401\": {\n description: \"Invalid credentials\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"500\": {\n description: \"Server error\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n }\n }\n }\n },\n \"/auth/logout\": {\n post: {\n tags: [\"auth\"],\n summary: \"Logout\",\n description: \"Invalidate the current session\",\n responses: {\n \"200\": {\n description: \"Logout successful\",\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n properties: {\n success: {\n type: \"boolean\",\n example: true\n },\n data: {\n type: \"object\",\n properties: {\n message: {\n type: \"string\",\n example: \"Logout successful\"\n }\n }\n }\n }\n }\n }\n }\n }\n }\n }\n },\n \"/auth/session\": {\n get: {\n tags: [\"auth\"],\n summary: \"Get current session\",\n description: \"Get information about the current authenticated session\",\n responses: {\n \"200\": {\n description: \"Session information\",\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n properties: {\n success: {\n type: \"boolean\",\n example: true\n },\n data: {\n type: \"object\",\n properties: {\n lead: {\n $ref: \"#/components/schemas/LeadOutput\"\n }\n }\n }\n }\n }\n }\n }\n },\n \"401\": {\n description: \"Not authenticated\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"500\": {\n description: \"Server error\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n }\n }\n }\n },\n \"/analysis/generate\": {\n post: {\n tags: [\"analysis\"],\n summary: \"Generate content calendar analysis\",\n description: \"Generate a new content calendar analysis using Gemini AI\",\n security: [\n {\n cookieAuth: []\n }\n ],\n requestBody: {\n required: true,\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/AnalysisInput\"\n }\n }\n }\n },\n responses: {\n \"200\": {\n description: \"Analysis generated successfully\",\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n properties: {\n success: {\n type: \"boolean\",\n example: true\n },\n data: {\n type: \"object\",\n properties: {\n id: {\n type: \"string\",\n format: \"uuid\",\n example: \"123e4567-e89b-12d3-a456-426614174000\"\n },\n calendar: {\n type: \"array\",\n items: {\n $ref: \"#/components/schemas/ContentCalendarItem\"\n }\n },\n created_at: {\n type: \"string\",\n format: \"date-time\",\n example: \"2023-01-01T12:00:00.000Z\"\n }\n }\n }\n }\n }\n }\n }\n },\n \"400\": {\n description: \"Invalid input\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"401\": {\n description: \"Not authenticated\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"500\": {\n description: \"Server error\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n }\n }\n }\n },\n \"/analysis/{id}\": {\n get: {\n tags: [\"analysis\"],\n summary: \"Get analysis by ID\",\n description: \"Retrieve a specific analysis by its UUID\",\n security: [\n {\n cookieAuth: []\n }\n ],\n parameters: [\n {\n name: \"id\",\n in: \"path\",\n required: true,\n schema: {\n type: \"string\",\n format: \"uuid\"\n },\n description: \"UUID of the analysis\"\n }\n ],\n responses: {\n \"200\": {\n description: \"Analysis retrieved successfully\",\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n properties: {\n success: {\n type: \"boolean\",\n example: true\n },\n data: {\n type: \"object\",\n properties: {\n id: {\n type: \"string\",\n format: \"uuid\",\n example: \"123e4567-e89b-12d3-a456-426614174000\"\n },\n calendar: {\n type: \"array\",\n items: {\n $ref: \"#/components/schemas/ContentCalendarItem\"\n }\n },\n prompt: {\n type: \"string\"\n },\n created_at: {\n type: \"string\",\n format: \"date-time\",\n example: \"2023-01-01T12:00:00.000Z\"\n }\n }\n }\n }\n }\n }\n }\n },\n \"401\": {\n description: \"Not authenticated\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"403\": {\n description: \"Unauthorized\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"404\": {\n description: \"Analysis not found\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"500\": {\n description: \"Server error\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n }\n }\n }\n },\n \"/analysis\": {\n get: {\n tags: [\"analysis\"],\n summary: \"List analyses\",\n description: \"List all analyses for the authenticated lead\",\n security: [\n {\n cookieAuth: []\n }\n ],\n responses: {\n \"200\": {\n description: \"Analyses retrieved successfully\",\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n properties: {\n success: {\n type: \"boolean\",\n example: true\n },\n data: {\n type: \"array\",\n items: {\n type: \"object\",\n properties: {\n id: {\n type: \"string\",\n format: \"uuid\",\n example: \"123e4567-e89b-12d3-a456-426614174000\"\n },\n created_at: {\n type: \"string\",\n format: \"date-time\",\n example: \"2023-01-01T12:00:00.000Z\"\n },\n summary: {\n type: \"string\",\n example: \"Content calendar analysis for website...\"\n }\n }\n }\n }\n }\n }\n }\n }\n },\n \"401\": {\n description: \"Not authenticated\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n },\n \"500\": {\n description: \"Server error\",\n content: {\n \"application/json\": {\n schema: {\n $ref: \"#/components/schemas/ErrorResponse\"\n }\n }\n }\n }\n }\n }\n }\n },\n components: {\n schemas: {\n LeadInput: {\n type: \"object\",\n required: [\"email\", \"name\", \"password\"],\n properties: {\n email: {\n type: \"string\",\n format: \"email\",\n example: \"user@example.com\"\n },\n name: {\n type: \"string\",\n example: \"John Doe\"\n },\n password: {\n type: \"string\",\n format: \"password\",\n example: \"securepassword123\"\n }\n }\n },\n LoginInput: {\n type: \"object\",\n required: [\"email\", \"password\"],\n properties: {\n email: {\n type: \"string\",\n format: \"email\",\n example: \"user@example.com\"\n },\n password: {\n type: \"string\",\n format: \"password\",\n example: \"securepassword123\"\n }\n }\n },\n LeadOutput: {\n type: \"object\",\n properties: {\n id: {\n type: \"integer\",\n example: 1\n },\n email: {\n type: \"string\",\n format: \"email\",\n example: \"user@example.com\"\n },\n name: {\n type: \"string\",\n example: \"John Doe\"\n }\n }\n },\n AnalysisInput: {\n type: \"object\",\n required: [\"prompt\"],\n properties: {\n prompt: {\n type: \"string\",\n example: \"Generate a content calendar for a supplement company\"\n },\n website: {\n type: \"string\",\n example: \"https://www.gsuplementos.com.br\"\n },\n month: {\n type: \"string\",\n example: \"Junho\"\n },\n year: {\n type: \"string\",\n example: \"2025\"\n }\n }\n },\n ContentCalendarItem: {\n type: \"object\",\n properties: {\n data: {\n type: \"string\",\n example: \"02/06/2025\"\n },\n conteudos: {\n type: \"array\",\n items: {\n type: \"object\",\n properties: {\n tipo: {\n type: \"string\",\n example: \"Post de Blog\"\n },\n titulo: {\n type: \"string\",\n example: \"Suplementos para ganho de massa: mitos e verdades\"\n },\n descricao: {\n type: \"string\",\n example: \"Descubra quais suplementos realmente funcionam para ganho de massa muscular\"\n },\n pontosPrincipais: {\n type: \"array\",\n items: {\n type: \"string\"\n },\n example: [\n \"Proteínas e seu papel no ganho muscular\",\n \"Creatina: o suplemento mais estudado\",\n \"Timing de suplementação para resultados otimizados\"\n ]\n },\n cta: {\n type: \"string\",\n example: \"Compre agora com 10% de desconto\"\n },\n persona: {\n type: \"string\",\n example: \"Praticantes de musculação intermediários\"\n },\n kpis: {\n type: \"array\",\n items: {\n type: \"string\"\n },\n example: [\n \"Conversões diretas\",\n \"Tempo médio de leitura\"\n ]\n },\n canais: {\n type: \"array\",\n items: {\n type: \"string\"\n },\n example: [\n \"Blog\",\n \"LinkedIn\"\n ]\n },\n recursos: {\n type: \"array\",\n items: {\n type: \"string\"\n },\n example: [\n \"Pesquisa científica\",\n \"Designer para infográficos\"\n ]\n },\n palavrasChave: {\n type: \"array\",\n items: {\n type: \"string\"\n },\n example: [\n \"suplementos\",\n \"ganho de massa\",\n \"whey protein\"\n ]\n },\n motivacaoEstrategica: {\n type: \"string\",\n example: \"Conteúdo educativo para topo de funil que atrai novos usuários\"\n }\n }\n }\n }\n }\n },\n ErrorResponse: {\n type: \"object\",\n properties: {\n success: {\n type: \"boolean\",\n example: false\n },\n error: {\n type: \"string\",\n example: \"Error message\"\n }\n }\n }\n },\n securitySchemes: {\n cookieAuth: {\n type: \"apiKey\",\n in: \"cookie\",\n name: \"session_id\"\n }\n }\n }\n};","deleted","label",[167,149],"backend","permalink","https://www.val.town/x/diegoivo/AgenteCalendarioConteudo/code/backend/swagger.ts","extension","actionData","errors"]