Skip to main content
A cota mensal é contada em créditos por questão liberada, não em requisições nem em exibições. Cada camada de uma questão é cobrada uma vez por ciclo, na primeira vez que ela chega à sua organização. Uma lista de 5 questões custa o mesmo que buscar essas 5 questões uma a uma pelo ID.

​
Quanto custa uma questão

Sem include, a resposta traz a questão com gabarito: 6 créditos por questão. Custam 0:
  • GET /v1/vestibulares/exams e GET /v1/vestibulares/subjects;
  • uma lista que não encontrou nenhuma questão;
  • qualquer resposta de erro, 4xx ou 5xx, 429 inclusive.

​
Reler não cobra

Uma questão já liberada no ciclo pode ser pedida de novo quantas vezes quiser, por qualquer chave da organização, sem gastar crédito: O ciclo é o da sua assinatura e recomeça todo mês, também nos planos anuais: nada se acumula. A reserva da próxima seção continua sendo o pior caso; o que vale é o custo cobrado, em X-Credits-Charged.

​
Questões distintas por ciclo

Cada plano limita quantas questões diferentes a organização libera por ciclo, em qualquer camada (include=none conta): Releitura nunca conta nem é recusada, mesmo no limite. Uma página que traria questões ainda não liberadas além do limite volta inteira como 429 com code: "DISTINCT_LIMIT_REACHED", sem custo e sem questões parciais. O contador de distintas é por organização, não por exame nem por matéria. Para acompanhar, toda resposta de questões traz o seu saldo de distintas: O 429 de distintas traz o mesmo saldo no corpo (distinct_used, distinct_limit, distinct_remaining) e a mensagem diz quantas ainda cabem. Quando distinct_remaining é maior que zero, repetir o pedido com limit menor passa. O aviso por e-mail chega aos 80%, 90% e 100% do teto, uma vez por ciclo cada, para o e-mail de cobrança da organização ou, sem ele, para os membros. Os dois limites medem coisas diferentes: as questões distintas limitam a abrangência (quantas questões você vê) e os créditos limitam a profundidade (o que você pede de cada uma). A cota de créditos é de 9 por questão distinta. Enquanto não houver resolução comentada, uma questão custa no máximo 6 créditos (3 do enunciado e 3 do gabarito), então o limite de distintas se esgota antes dos créditos. Com a resolução (+6), os créditos passam a pesar.

​
Bloco extra

Nos planos pagos (Starter, Pro e Business), dá para ampliar o ciclo com um **bloco extra de +10.000 questões distintas e +90.000 créditos por R400∗∗(cercadeR 400** (cerca de R 0,04 por questão distinta). Os dois limites sobem juntos: o de distintas e a cota mensal de créditos (9 créditos por questão distinta). Sem excedente, o bloco é a única forma de ir além da cota no mesmo ciclo. É um pagamento único, feito no painel, em Faturamento:
  • vale só para o ciclo em que foi comprado e não acumula para o seguinte;
  • cada ciclo comporta até 5 blocos (+50.000); passando disso, o caminho é um plano maior;
  • o bloco é liberado quando o pagamento é confirmado, não ao abrir o checkout;
  • o Free e o Enterprise não compram blocos: o Free faz upgrade e o Enterprise não tem limite de distintas.
Os dois 429 — o de cota de créditos e o DISTINCT_LIMIT_REACHED — já avisam quando um bloco resolve. Planos antigos contados em requisições não ganham créditos com o bloco.

​
Escolher as camadas com include

GET /v1/vestibulares/questions e GET /v1/vestibulares/questions/{id} aceitam include, com as camadas separadas por vírgula: Qualquer outro valor devolve 400 e não custa nada.
Só os enunciados, 3 créditos cada
Duas regras para ler a resposta:
  • Camada não pedida não aparece. Com include=none, a questão vem sem correctAlternative e as alternativas vêm sem isCorrect. Sem resolucao, não existe o campo resolution.
  • Camada pedida que a questão não tem vem null, e não é cobrada. Uma questão sem resolução, com include=gabarito,resolucao, vem com "resolution": null e custa 6. Uma questão sem gabarito vem com "correctAlternative": null e isCorrect: null em todas as alternativas, e custa 3.
isCorrect: null quer dizer “sem gabarito”, não “alternativa errada”. Trate os três valores: true, false e null.
Uma questão com include=gabarito,resolucao
resolution é HTML, como statement: renderize sanitizado.

​
A reserva

Antes de executar uma lista, a API reserva o pior caso: limit × créditos por questão das camadas pedidas. Depois da resposta, cobra só o que foi entregue e devolve a sobra ao saldo. A busca por ID reserva o custo de uma questão com as camadas pedidas.
Perto do fim do saldo, uma página grande pode receber 429 mesmo quando uma menor caberia: a reserva é recusada se não couber no que resta. A mensagem do 429 diz quanto a requisição reservou e quanto resta no ciclo. Reduza limit ou tire camadas de include e tente de novo.
429 por reserva

​
Plano Free

O Free é permanente, com o acervo completo e dois limites por ciclo mensal: 60 questões distintas e 540 créditos. Reler uma questão já liberada não conta nem gasta crédito, então o limite que vale é o de 60 questões: 60 com gabarito custam 360 créditos, e os 180 restantes só se gastam com resolução comentada. A cota renova a cada ciclo; acabou antes, a resposta é 429 até a renovação.

​
Listas e o padrão de limit

A lista padrão é limit=20 com gabarito: reserva 120 créditos, quase um quarto do mês do Free. Os exemplos desta documentação usam limit=5, para pedir só a página que vai ser exibida.

​
Acompanhar o saldo

Toda resposta de /v1/vestibulares/* diz quanto custou e quanto resta:
O saldo do ciclo também aparece no painel, na Visão geral e em Faturamento.
Planos contratados antes da cobrança por créditos continuam contando 1 por requisição até a migração combinada com você, e respondem com X-Quota-Unit: request. Neles X-Credits-Charged também aparece, mostrando quanto a requisição custaria em créditos, sem descontar nada da cota.
Os limites por minuto e por dia e o 429 estão em Autenticação.