MessGEODocs
Obter chave de API

Criar chave, primeiro pedido

Precisa de uma conta MessGEO com email verificado e de créditos ou de um pacote de Monitorização de Prompts.

1. Crie uma chave

Abra API no seu painel, escolha Criar chave, dê-lhe um nome, marque apenas os âmbitos necessários e copie a chave. Só é mostrada uma vez.

2. Verifique a chave

curl https://api.messgeo.com/v1/me \
  -H "Authorization: Bearer mgk_xxxxxxxxxx_your_secret"

Uma resposta bem-sucedida tem sempre data e meta.

{
  "data": {
    "account": { "credits": 120 },
    "key": { "scopes": ["account:read", "tools:run"] }
  },
  "meta": { "request_id": "req_abc123", "next_cursor": null }
}

3. Execute uma ferramenta

dry_run mostra o custo e nada gasta.

curl -X POST https://api.messgeo.com/v1/tools/ai-readiness-score/runs \
  -H "Authorization: Bearer mgk_xxxxxxxxxx_your_secret" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/", "dry_run": true}'

Para executar de facto, envie um Idempotency-Key. Se o pedido for repetido com a mesma chave, é devolvido o primeiro resultado e não há segunda cobrança.

curl -X POST https://api.messgeo.com/v1/tools/ai-readiness-score/runs \
  -H "Authorization: Bearer mgk_xxxxxxxxxx_your_secret" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-unique-key-001" \
  -d '{"url": "https://example.com/"}'