Mapaprop
DEVELOPING

Cota mensal e limites

O Zonaprop limita a quantidade de chamadas que podem ser feitas por imobiliária. O limite é do portal, não nosso, e cada imobiliária o acorda com eles.

Cota habitual1500 chamadas por mês
Contada porcada imobiliária, não pela sua aplicação
É renovadano dia 1 às 00:00 (horário da Argentina), de uma só vez
Saldo não usadonão acumula — o que você não usou se perde

O fato de ser por imobiliária tem uma consequência prática: o consumo de um cliente não afeta os outros, e se um ficar sem cota, só as operações dele são interrompidas.

O que consome cota e o que não

É o que mais convém deixar claro, porque não é evidente:

OperaçãoConsome?
Conectar a conta (quando o seu cliente autoriza)sim, 1
Desconectar a contasim, 1
Publicar, atualizar ou retirar um anúnciosim
Consultar o estado da conexão (GET /connections)não
Solicitar um link de conexãonão

As duas últimas leem o nosso registro, não o do portal.

Os erros também consomem cota. Uma chamada que falha por dados inválidos é descontada igual a uma bem-sucedida. Repetir em loop uma operação que vem falhando gasta a cota do mês do seu cliente sem conseguir nada.

Quanto resta a ele

Devolvemos esse dado na conexão, sem que você precise perguntar ao portal:

curl https://property-api.mapaprop.com/connections/zonapropapi \
  -H "Authorization: Bearer <SEU_TOKEN>" \
  -H "x-client-ref: cliente-42"

{
  "connection": {
    "portal": "zonapropapi",
    "status": "active",
    "appMeta": {
      "quotaRemaining": 1494,
      "quotaLimit": 1500,
      "quotaReadAt": "2026-10-01T20:44:40.323Z"
    }
  }
}

quotaRemaining é o último valor que o portal nos informou, não uma consulta ao vivo. Por isso vem com quotaReadAt: olhe esse campo para saber de quando é. Se o seu cliente operou por outro meio desde então, o número real pode ser menor.

Consultá-lo não consome cota justamente porque não perguntamos ao portal.

Planos de publicação

O Zonaprop também limita quantos anúncios cada imobiliária pode ter publicados, de acordo com os planos que tenha contratado. Isso é independente da cota de chamadas.

"plans": [
  { "plan": "Destacado", "planTotal": 50, "planAvailable": 12 }
]

Devolvemos esse dado na mesma resposta. Assim como a cota, é o último valor conhecido: se o seu cliente publicar pelo painel do Zonaprop, ele diminui sem que fiquemos sabendo.

Uma conta sem planos conecta do mesmo jeito. plans: [] significa que o Zonaprop ainda não atribuiu nenhum — a conexão é válida, mas ele não vai conseguir publicar até contratá-los com o portal. É algo que o seu cliente resolve diretamente com eles.

Desconectar

DELETE /connections/zonapropapi faz duas coisas: deixa de reconhecer a conexão do nosso lado e avisa ao portal que não operamos mais em nome daquela imobiliária.

As duas são necessárias. No Zonaprop não existe uma credencial por conta que possamos apagar, então, se apenas anotássemos do nosso lado, o portal continuaria nos reconhecendo.

A resposta informa como foi:

{ "status": "revoked", "remoteUnlink": "ok", "externalListingsUntouched": true }
  • remoteUnlink: "ok" — desvinculado também no portal.
  • remoteUnlink: "pending" — o seu cliente já está desconectado do nosso lado, mas o portal não respondeu. Chame novamente mais tarde.

Desconectar não retira os anúncios. Os anúncios publicados no Zonaprop são do seu cliente e continuam online. Se ele quiser retirá-los, precisa fazer isso antes de desconectar, ou diretamente pelo portal.

Relacionado