{"openapi":"3.1.0","info":{"title":"Hub Sellfy CRM — API Pública v1","version":"1.0.0","description":"API REST pública do Hub Sellfy CRM. Autenticação via Bearer token (`hs_live_*`). Rate limit: 60 req/min por chave.","contact":{"name":"Hub Sellfy","url":"https://hubsellfy.com"}},"servers":[{"url":"https://app.hubsellfy.com/api/v1","description":"Produção"}],"security":[{"bearerAuth":[]}],"paths":{"/leads":{"get":{"operationId":"listLeads","summary":"Listar leads","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"status","in":"query","schema":{"type":"string","enum":["novo","contatado","qualificado","perdido"]}}],"responses":{"200":{"description":"Lista paginada de leads","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"operationId":"createLead","summary":"Criar lead","description":"Cria um lead e um deal inicial. Deduplicação por e-mail ou telefone é ativa por padrão.","parameters":[{"name":"dedup","in":"query","description":"Use false para desativar a deduplicação nesta criação.","schema":{"type":"boolean","default":true}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadInput"}}}},"responses":{"201":{"description":"Lead criado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"409":{"description":"Lead duplicado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Limite do plano ou assignee inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/leads/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"operationId":"getLead","summary":"Obter lead","responses":{"200":{"description":"Detalhes do lead","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"operationId":"updateLead","summary":"Atualizar lead","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadUpdate"}}}},"responses":{"200":{"description":"Lead atualizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Assignee inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/deals":{"get":{"operationId":"listDeals","summary":"Listar deals","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"stage","in":"query","schema":{"$ref":"#/components/schemas/DealStage"}},{"name":"lead_id","in":"query","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Lista paginada de deals","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"operationId":"createDeal","summary":"Criar deal","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealInput"}}}},"responses":{"201":{"description":"Deal criado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Lead não encontrado no workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Assignee inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key no formato `hs_live_*`"}},"responses":{"BadRequest":{"description":"JSON ou dados inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"API key inválida ou ausente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Recurso não encontrado no workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limit excedido (60 req/min por chave)","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Segundos até nova tentativa."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"LeadStatus":{"type":"string","enum":["novo","contatado","qualificado","perdido"]},"DealStage":{"type":"string","enum":["novo_lead","contato_realizado","proposta_enviada","negociacao","fechado_ganho","fechado_perdido"]},"LeadInput":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":120},"email":{"anyOf":[{"type":"string","format":"email","maxLength":254},{"type":"string","enum":[""]}]},"phone":{"type":"string","maxLength":40},"company":{"type":"string","maxLength":120},"job_title":{"type":"string","maxLength":120},"status":{"$ref":"#/components/schemas/LeadStatus"},"assignee_id":{"type":"string","format":"uuid"}}},"LeadUpdate":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":120},"email":{"anyOf":[{"type":"string","format":"email","maxLength":254},{"type":"string","enum":[""]}]},"phone":{"type":"string","maxLength":40},"company":{"type":"string","maxLength":120},"job_title":{"type":"string","maxLength":120},"status":{"$ref":"#/components/schemas/LeadStatus"},"assignee_id":{"type":["string","null"],"format":"uuid"}}},"DealInput":{"type":"object","additionalProperties":false,"required":["title"],"properties":{"title":{"type":"string","minLength":1,"maxLength":160},"value":{"type":"number","minimum":0},"stage":{"$ref":"#/components/schemas/DealStage"},"lead_id":{"type":["string","null"],"format":"uuid"},"assignee_id":{"type":["string","null"],"format":"uuid"},"due_date":{"type":"string","maxLength":40}}},"Lead":{"type":"object","additionalProperties":true,"required":["id","name"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"company":{"type":["string","null"]},"job_title":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/LeadStatus"},"assignee_id":{"type":["string","null"],"format":"uuid"}}},"Deal":{"type":"object","additionalProperties":true,"required":["id","title"],"properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"value":{"type":"number"},"stage":{"$ref":"#/components/schemas/DealStage"},"lead_id":{"type":["string","null"],"format":"uuid"},"assignee_id":{"type":["string","null"],"format":"uuid"},"due_date":{"type":["string","null"]}}},"LeadResponse":{"type":"object","required":["lead"],"properties":{"lead":{"$ref":"#/components/schemas/Lead"}}},"DealResponse":{"type":"object","required":["deal"],"properties":{"deal":{"$ref":"#/components/schemas/Deal"}}},"LeadListResponse":{"type":"object","required":["leads","total","page","pageSize"],"properties":{"leads":{"type":"array","items":{"$ref":"#/components/schemas/Lead"}},"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"pageSize":{"type":"integer","minimum":1,"maximum":100}}},"DealListResponse":{"type":"object","required":["deals","total","page","pageSize"],"properties":{"deals":{"type":"array","items":{"$ref":"#/components/schemas/Deal"}},"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"pageSize":{"type":"integer","minimum":1,"maximum":100}}},"Error":{"type":"object","required":["error"],"additionalProperties":true,"properties":{"error":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}