Proxy Interno - Listar cidades disponíveis

Retorna a lista de cidades disponíveis para uso nos campos proxy_managed_country, proxy_managed_state e proxy_managed_city do endpoint POST /instance/connect.

O backend consulta o catálogo disponível e aplica um cache interno de 24 horas. Se o catálogo de cidades não estiver disponível, o endpoint retorna erro.

• Autenticação: requer token válido de qualquer instância (ou admin token via instância).
• Query country (opcional): ISO alpha-2 minúsculo. Default br.
• Query state (opcional): UF/subdivisão minúscula, como sp.
• Query search (opcional): filtro parcial por nome/slug, insensível a acento/caixa.

Como escolher a cidade:

1. Use br em proxy_managed_country.
2. Chame GET /proxy-managed/cities?country=br para obter as cidades brasileiras.
3. Quando a cidade retornar state, envie também esse valor em proxy_managed_state.
4. Quando o usuário escolher uma cidade, envie em /instance/connect:
   • proxy_managed_country: o país escolhido, ex. br
   • proxy_managed_state: o state retornado pela cidade, ex. sp, quando disponível
   • proxy_managed_city: sempre o cities[].value

Se state não vier na cidade selecionada, envie apenas proxy_managed_country e proxy_managed_city. O backend valida a combinação e retorna erro se faltar algum dado necessário.

Exemplo de requisição:

GET /proxy-managed/cities?country=br&state=sp&search=camp