---
title: "API do Desenvolvedor | afka"
description: "Crie tarefas, leia resultados e receba webhooks assinados sob os mesmos controles de workspace."
url: "https://afka.ai/pt/developers"
lang: "pt"
---

Recursos / Desenvolvedores

# Sua candidatura pede. afka faz o trabalho.

Criar tarefas, recuperar resultados e receber eventos assinados. As mesmas permissões e gates de aprovação se aplicam independentemente de uma pessoa ou seu código iniciar o trabalho.

## Do pedido ao resultado.

Use a API de tarefas para entregar um resultado claro. Acompanhe a tarefa, recupere seus artefatos e traga o resultado de volta para sua própria aplicação.

[Gerenciar chaves de API](https://app.afka.ai/settings/api) Explorar a API ↓

POST https://api.afka.ai/v1/tasks { "prompt": "Prepare an evidence-backed candidate shortlist" } 202 Accepted { "task_id": "task_5f2c", "status": "queued" } GET https://api.afka.ai/v1/tasks/task_5f2c { "status": "done", "credits_spent": 412, "artifacts": ["art_9d1e"] }

## Uma pequena superfície. Um ciclo de trabalho completo.

| Solicitação | O que faz | Resultado |
| --- | --- | --- |
| POST /v1/tasks | Envie um resultado para afka trabalhar. | Tarefa enfileirada e ID da tarefa |
| GET /v1/tasks/:id | Leia a execução e seu status atual. | Status, créditos gastos e artefatos |
| tarefa.concluída | Receba um evento de conclusão no seu webhook. | Referências de tarefa e espaço de trabalho |

## Uma chave nunca é um atalho para contornar o controle.

Acesso

### [Herda permissões](https://afka.ai/pt/security)

Uma chave nunca tem mais acesso do que a pessoa que a criou.

Ler visão geral de segurança ↗

Aprovação

### [O mesmo portão humano](https://afka.ai/pt/platform)

Ações sensíveis ainda aguardam a pessoa autorizada.

Explore as aprovações ↗

Registro

### [Rastrear o resultado](https://afka.ai/pt/platform)

Siga a tarefa e as ações por trás do artefato entregue.

Explore a plataforma ↗

## Eventos assinados. Retentativas seguras.

POST https://your-app.example/afka/hooks x-afka-event: task.finished x-afka-delivery: d_8f3a1c9e x-afka-signature: sha256=<hex digest> expected = hmac_sha256(signing_secret, raw_body).hexdigest()

Verifique a assinatura contra os bytes brutos da solicitação antes de analisar o corpo. Use o ID de entrega estável para desduplicar tentativas. Mantenha os segredos de assinatura no servidor.

## Construir em um loop de trabalho governado.

Comece com uma tarefa. Expanda quando o resultado e o caminho de aprovação forem adequados para sua equipe.

[Começar gratuitamente](https://app.afka.ai/signup) [Agendar uma demonstração](https://afka.ai/pt/book-demo)
