# API de verificação de texto com chave e JSON simples.

> Como chamar a verificação de sinais de IA a partir dos seus programas: chave, endpoints, exemplos em curl, Python e Node.js, erros e limites.

- URL: https://authortext.com/pt/developers
- Language: pt
- Site: AuthorText (https://authortext.com/)

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.

## Endpoints

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

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

## 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.

## API por chave: planos Pro e Máx

Preços e limites vêm do servidor, por isso não divergem dos reais. Live data: https://authortext.com/api/plans.

- 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

## 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.

## 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».

## Links

- [Home](https://authortext.com/pt/index.md)
- [plans](https://authortext.com/pt/plans.md)
- [help](https://authortext.com/pt/help.md)
- [developers](https://authortext.com/pt/developers.md)
- [about](https://authortext.com/pt/about.md)
- [method](https://authortext.com/pt/method.md)
- [faq](https://authortext.com/pt/faq.md)
- [privacy](https://authortext.com/pt/privacy.md)
- [terms](https://authortext.com/pt/terms.md)
- [articles](https://authortext.com/pt/articles/index.md)