// DEVELOPER API

API de verificação de textocom chave e JSON simples.

A mesma análise do site para os seus programas: pontuação, métricas, pontos do texto com citações, limpeza e marcação. Pedidos e respostas em JSON.

Obter chave API Endpoints

caracteres: ...
pedidos já: ...
pedidos por s: ...
por mês: ...

1curl -s https://authortext.com/api/analyze \2  -H "Authorization: Bearer atk_YOUR_KEY" \3  -H "Content-Type: application/json" \4  -d '{"text": "It is important to note that various factors play a crucial role."}'

200 OK/ application/json/ Resposta abreviada: nem todos os campos são mostrados

{  "probability": 36.048,  "confidence": "LOW",  "band": { "index": 2, "key": "mixed" },  "evidence": [    { "type": "phrase", "line": 1, "why": "high",      "excerpt": ">>>It is important to note<<< that various ..." }  ],  "stats": { "words": 12, "sentences": 1 }}

01/Endpoints

Estes pedidos aceitam a chave; os pedidos da área pessoal e de pagamento não a aceitam.

POST /api/analyze Pontuação, métricas, pontos do texto com citações, marcas de águacorpo: {"text": "..."} 1 pedido
POST /api/clean Limpeza: remove símbolos ocultos e tipografia; um texto demasiado longo é cortado no limite do plano (truncated, limit)corpo: {"text": "..."} 1 pedido
POST /api/highlight Marcação dos trechos encontrados para realcecorpo: {"text": "..."} 1 pedido
POST /api/fetch-url Carrega uma página pelo endereço e analisa o textocorpo: {"url": "..."} 5 pedidos
POST /api/extract-file Texto de um ficheiro: PDF, DOCX, ODT, RTF, EPUB, FB2, HTML, TXTcorpo: ficheiro 5 pedidos
GET /api/me O plano da chave e os seus limites não gasta pedidos

02/O que convém saber

Sem armazenamento

O texto é processado em memória, não é escrito em disco nem vai para os registos.

Chave e plano

A chave é criada na área pessoal e mostrada uma só vez; o servidor guarda apenas a impressão digital. Uma chave nova substitui a anterior.

Um só formato de erro

Um erro tem sempre a forma {"error": {"code", "message"}}, sem rastreios.

Texto, ligação, ficheiro

Pode enviar um texto, o endereço de uma página ou um documento inteiro.

03/API por chave: planos Pro e Máx

Preços e limites vêm do servidor, por isso não divergem dos reais.

Pro

-por mês

- caracteres por pedido- pedidos de imediato- pedidos por segundo

Escolher subscrição

A chave de API está incluída nos planos Pro e Máx.
Todos os tipos de análise e análise por fragmentos
Cabeçalho Authorization: Bearer para análise, limpeza, marcação, carregamento por ligação e de ficheiro
A chave funciona enquanto o período pago estiver ativo

04/Erros e limites

Código HTTP	code	Quando
400	`invalid_json`	O corpo do pedido não é JSON válido
413	`payload_too_large`	O corpo do pedido é demasiado grande
415	`unsupported_media_type`	Content-Type não é application/json
422	`empty_text / invalid_text`	O campo text está vazio, em falta ou não é texto
422	`text_too_long`	Texto acima do limite do plano; a resposta traz limit e plan
429	`rate_limited`	Demasiado depressa; veja o cabeçalho Retry-After

Os pedidos contam como uma «rajada»: primeiro pode fazer tantos pedidos seguidos quantos indicados acima, depois esse número por segundo. Carregar por ligação ou de ficheiro custa 5 pedidos; um texto com mais de 100 000 caracteres custa mais 1 pedido por cada 100 000.
Uma chave em falta, errada ou expirada não dá erro: o pedido é tratado como gratuito, com os limites gratuitos (3 000 caracteres). Confirme o plano com GET /api/me.
A pontuação é uma indicação, não prova de autoria.

// API KEY

A chave é criada na área pessoal

Subscreva o plano Pro ou Máx, abra a secção «Chave API» na área pessoal e carregue em «Criar chave».

Abrir a área pessoal