{"openapi":"3.1.0","info":{"title":"Fala Cheese API","version":"1.0.0","description":"API pública do Fala Cheese pra automatizar criação de posts em 9+ redes sociais brasileiras. Autenticação via Bearer token (API key gerada em /app/settings).","contact":{"email":"suporte@falacheese.com.br"}},"servers":[{"url":"https://app.falacheese.com.br"}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"fc_live_xxxxxxxxxxxx"}},"schemas":{"Platform":{"type":"string","enum":["facebook","instagram","linkedin","twitter","threads","bluesky","mastodon","pinterest","tiktok","youtube"]},"CreatePostRequest":{"type":"object","required":["body"],"properties":{"body":{"type":"string","description":"Texto do post (será adaptado pra cada plataforma)."},"platforms":{"type":"array","items":{"$ref":"#/components/schemas/Platform"},"description":"Plataformas-alvo. Usa todas as contas ativas dessa plataforma na workspace. Use platforms OU socialAccountIds."},"socialAccountIds":{"type":"array","items":{"type":"string"},"description":"IDs específicos de contas sociais. Use se quiser escolher exatamente quais contas (ex: tem 2 IGs e só quer 1)."},"mediaUrls":{"type":"array","items":{"type":"string","format":"uri"},"description":"URLs públicas de mídia. O Fala Cheese baixa e salva como MediaAsset antes de postar.","maxItems":10},"scheduledAt":{"type":"string","format":"date-time","nullable":true,"description":"ISO 8601 UTC. Se omitido e publishNow=true, posta agora."},"publishNow":{"type":"boolean","description":"Posta imediatamente (sem agendamento).","default":false}}},"CreatePostResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"postId":{"type":"string"},"published":{"type":"integer","description":"Quantas publicações imediatas funcionaram"},"failed":{"type":"integer"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"security":[{"ApiKey":[]}],"paths":{"/api/v1/posts":{"post":{"operationId":"createPost","summary":"Cria um post em N redes sociais","description":"Cria um post agendado ou publica imediatamente em qualquer combinação das 10 redes sociais conectadas.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePostRequest"}}}},"responses":{"201":{"description":"Post criado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePostResponse"}}}},"400":{"description":"Payload inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Não autenticado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Quota excedida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Plano sem acesso a API","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}