Crivum Avaliacoes API
The Avaliacoes API from Crivum — 2 operation(s) for avaliacoes.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/crivum-org:crivum-org-avaliacoes-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Crivum Avaliacoes API
version: v1
description: A Crivum mede um texto contra critérios padronizados por três modelos de referência e devolve um resultado de 0 a 100 com a decomposição por critério e a divergência entre eles. Quando o trabalho passa do piso e a autora assina, a Crivum deposita um DOI Crossref, publica uma página citável e guarda prova de anterioridade.
servers:
- url: https://crivum.org
- url: https://crivum.dev
tags:
- name: Avaliacoes
paths:
/v1/avaliacoes:
post:
summary: Mede um texto contra os critérios publicados
description: Cria uma avaliação nova ou, com a mesma referência de uma chamada anterior da mesma chave, devolve o resultado já existente sem medir de novo. Texto acima de 60.000 caracteres é recusado com a causa texto_grande_demais.
security:
- bearerAuth: []
parameters:
- name: X-Crivum-Canal
in: header
required: false
description: Canal de origem do pedido. Sem este header, o canal registrado é direto.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
texto:
type: string
minLength: 1
titulo:
type: string
minLength: 1
maxLength: 300
tipo:
type: string
enum:
- pesquisa
- revisao
- teorico
- relato
- ensaio
- resumo
- pratica
- ensino
- didatico
nivel:
type: string
enum:
- T
- G
- E
- M
- D
- P
- auto
referencia:
type: string
minLength: 1
maxLength: 200
required:
- texto
- titulo
- tipo
- referencia
additionalProperties: false
responses:
'200':
description: Referência já conhecida, resultado reaproveitado.
content:
application/json:
example:
ok: true
referencia: pedido-2026-09-0001
estado: concluida
admissibilidade: sim
medicao:
criterios:
- criterioId: 1
titulo: Clareza e estrutura argumentativa
pontos: 12
possivel: 15
divergencia: 2
- criterioId: 2
titulo: Originalidade da contribuição
pontos: 10
possivel: 15
divergencia: 3
- criterioId: 3
titulo: Honestidade intelectual e reconhecimento de limitações
pontos: 13
possivel: 15
divergencia: 1
- criterioId: 4
titulo: Ancoragem em referências e estado da arte
pontos: 11
possivel: 15
divergencia: 2
- criterioId: 5
titulo: Transparência do contexto e dos dados do caso
pontos: 15
possivel: 20
divergencia: 4
- criterioId: 6
titulo: Transferibilidade e lições acionáveis
pontos: 13
possivel: 20
divergencia: 3
divergencia: 15
versoes:
rubrica: v1
tabela_de_tier: v1
limiares: v1
avaliadoras_reais: 3
score: 74
tier: B
codigo: Crivum MB74
sinais:
- tipo: borderline_score
rotulo: pontuação na fronteira do limiar
detalhe: Score 74 na fronteira de limiar.
sugestao: Reforce os critérios em que a obra ficou mais fraca com dados, método e resultados explícitos antes de reenviar.
registro:
elegivel: false
motivos:
- score_abaixo_do_piso
- originalidade_nao_medida_em_modo_live
- assinatura_da_titular_pendente
falta_o_que:
- O score ficou abaixo do piso de 75 pontos que libera o registro.
- A originalidade ainda não é medida em modo live nesta fase.
- A titular ainda não assinou a publicação.
consumo:
laudas: 4
escada_de_preco:
creditos_base: 4
desconto: 0
degrau_promocional: false
saldo:
livres: 42
pagas: 4
total: 46
nao_e: Isto não é peer review. A leitura é feita por três modelos de referência contra critérios publicados, sem parecerista humano na maioria das obras, e a casa nunca usa a expressão peer review para descrever o próprio trabalho. Isto não coloca a obra em base de indexação acadêmica. O DOI torna a obra citável e localizável, e quem indexa é cada base pelos próprios critérios. Isto não é selo de instituição de ensino e não vale como título. O resultado é uma medição com versão gravada e endereço público, e quem lê decide o que fazer com ela. A casa mede texto em qualquer idioma e responde no idioma do texto, e os critérios foram calibrados em português e em inglês, então comparar resultado entre idiomas diferentes é leitura que ninguém mediu ainda.
contrato: v1
'201':
description: Medição concluída.
content:
application/json:
example:
ok: true
referencia: pedido-2026-09-0001
estado: concluida
admissibilidade: sim
medicao:
criterios:
- criterioId: 1
titulo: Clareza e estrutura argumentativa
pontos: 12
possivel: 15
divergencia: 2
- criterioId: 2
titulo: Originalidade da contribuição
pontos: 10
possivel: 15
divergencia: 3
- criterioId: 3
titulo: Honestidade intelectual e reconhecimento de limitações
pontos: 13
possivel: 15
divergencia: 1
- criterioId: 4
titulo: Ancoragem em referências e estado da arte
pontos: 11
possivel: 15
divergencia: 2
- criterioId: 5
titulo: Transparência do contexto e dos dados do caso
pontos: 15
possivel: 20
divergencia: 4
- criterioId: 6
titulo: Transferibilidade e lições acionáveis
pontos: 13
possivel: 20
divergencia: 3
divergencia: 15
versoes:
rubrica: v1
tabela_de_tier: v1
limiares: v1
avaliadoras_reais: 3
score: 74
tier: B
codigo: Crivum MB74
sinais:
- tipo: borderline_score
rotulo: pontuação na fronteira do limiar
detalhe: Score 74 na fronteira de limiar.
sugestao: Reforce os critérios em que a obra ficou mais fraca com dados, método e resultados explícitos antes de reenviar.
registro:
elegivel: false
motivos:
- score_abaixo_do_piso
- originalidade_nao_medida_em_modo_live
- assinatura_da_titular_pendente
falta_o_que:
- O score ficou abaixo do piso de 75 pontos que libera o registro.
- A originalidade ainda não é medida em modo live nesta fase.
- A titular ainda não assinou a publicação.
consumo:
laudas: 4
escada_de_preco:
creditos_base: 4
desconto: 0
degrau_promocional: false
saldo:
livres: 42
pagas: 4
total: 46
nao_e: Isto não é peer review. A leitura é feita por três modelos de referência contra critérios publicados, sem parecerista humano na maioria das obras, e a casa nunca usa a expressão peer review para descrever o próprio trabalho. Isto não coloca a obra em base de indexação acadêmica. O DOI torna a obra citável e localizável, e quem indexa é cada base pelos próprios critérios. Isto não é selo de instituição de ensino e não vale como título. O resultado é uma medição com versão gravada e endereço público, e quem lê decide o que fazer com ela. A casa mede texto em qualquer idioma e responde no idioma do texto, e os critérios foram calibrados em português e em inglês, então comparar resultado entre idiomas diferentes é leitura que ninguém mediu ainda.
contrato: v1
'400':
description: Corpo fora do contrato desta rota.
content:
application/json:
schema:
type: object
description: Envelope de ERRO da porta. Sempre ok:false — a chamada foi recusada antes de medir.
properties:
ok:
type: boolean
enum:
- false
codigo:
type: string
frase:
type: string
como_corrigir:
type: string
documentacao:
type: string
contrato:
type: string
cobrado:
type: boolean
required:
- ok
- codigo
- frase
- como_corrigir
- documentacao
- contrato
- cobrado
'401':
description: Chave ausente, inválida, revogada ou vencida.
content:
application/json:
schema:
type: object
description: Envelope de ERRO da porta. Sempre ok:false — a chamada foi recusada antes de medir.
properties:
ok:
type: boolean
enum:
- false
codigo:
type: string
frase:
type: string
como_corrigir:
type: string
documentacao:
type: string
contrato:
type: string
cobrado:
type: boolean
required:
- ok
- codigo
- frase
- como_corrigir
- documentacao
- contrato
- cobrado
'402':
description: Saldo de laudas insuficiente para esta chamada.
content:
application/json:
schema:
type: object
description: Envelope de RESULTADO DE MEDIÇÃO. Nunca traz ok — não é um veredito sobre a chamada, é o que foi medido.
properties:
referencia:
type: string
estado:
type: string
enum:
- falhou
causa:
type: string
motivo_publico:
type: string
contrato:
type: string
required:
- referencia
- estado
- causa
- contrato
'422':
description: A casa recusou o conteúdo enviado.
content:
application/json:
schema:
type: object
description: Envelope de RESULTADO DE MEDIÇÃO. Nunca traz ok — não é um veredito sobre a chamada, é o que foi medido.
properties:
referencia:
type: string
estado:
type: string
enum:
- falhou
causa:
type: string
motivo_publico:
type: string
contrato:
type: string
required:
- referencia
- estado
- causa
- contrato
'429':
description: Limite de vazão ou teto de gasto da chave excedido.
content:
application/json:
schema:
type: object
description: Envelope de ERRO da porta. Sempre ok:false — a chamada foi recusada antes de medir.
properties:
ok:
type: boolean
enum:
- false
codigo:
type: string
frase:
type: string
como_corrigir:
type: string
documentacao:
type: string
contrato:
type: string
cobrado:
type: boolean
required:
- ok
- codigo
- frase
- como_corrigir
- documentacao
- contrato
- cobrado
'503':
description: A casa está indisponível ou fora do ar para esta chamada.
content:
application/json:
schema:
oneOf:
- type: object
description: Envelope de ERRO da porta. Sempre ok:false — a chamada foi recusada antes de medir.
properties:
ok:
type: boolean
enum:
- false
codigo:
type: string
frase:
type: string
como_corrigir:
type: string
documentacao:
type: string
contrato:
type: string
cobrado:
type: boolean
required:
- ok
- codigo
- frase
- como_corrigir
- documentacao
- contrato
- cobrado
- type: object
description: Envelope de RESULTADO DE MEDIÇÃO. Nunca traz ok — não é um veredito sobre a chamada, é o que foi medido.
properties:
referencia:
type: string
estado:
type: string
enum:
- falhou
causa:
type: string
motivo_publico:
type: string
contrato:
type: string
required:
- referencia
- estado
- causa
- contrato
tags:
- Avaliacoes
operationId: postV1Avaliacoes
x-operation-id-source: derived
/v1/avaliacoes/{id}:
get:
summary: Reconsulta uma avaliação pela referência escolhida no pedido original
security:
- bearerAuth: []
parameters:
- name: id
in: path
required: true
description: A mesma referência enviada em POST /v1/avaliacoes.
schema:
type: string
responses:
'200':
description: Avaliação encontrada para esta chave.
content:
application/json:
example:
ok: true
referencia: pedido-2026-09-0002
estado: medindo
contrato: v1
'401':
description: Chave ausente, inválida, revogada ou vencida.
content:
application/json:
schema:
type: object
description: Envelope de ERRO da porta. Sempre ok:false — a chamada foi recusada antes de medir.
properties:
ok:
type: boolean
enum:
- false
codigo:
type: string
frase:
type: string
como_corrigir:
type: string
documentacao:
type: string
contrato:
type: string
cobrado:
type: boolean
required:
- ok
- codigo
- frase
- como_corrigir
- documentacao
- contrato
- cobrado
'404':
description: Nenhuma avaliação com esta referência para esta chave.
content:
application/json:
schema:
type: object
description: Envelope de ERRO da porta. Sempre ok:false — a chamada foi recusada antes de medir.
properties:
ok:
type: boolean
enum:
- false
codigo:
type: string
frase:
type: string
como_corrigir:
type: string
documentacao:
type: string
contrato:
type: string
cobrado:
type: boolean
required:
- ok
- codigo
- frase
- como_corrigir
- documentacao
- contrato
- cobrado
tags:
- Avaliacoes
operationId: getV1AvaliacoesById
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Chave de API da conta, enviada como Authorization: Bearer <chave>.'