Use Terraform ou OpenTofu

O provedor oficial do Caputchin deixa você gerenciar sua conta como infraestrutura como código: declare equipes, chaves de site, política de segurança, membros e tokens em arquivos .tf e aplique-os como qualquer outro recurso. É a mesma API de gestão de tudo o mais em automação, expressa como recursos do Terraform.

Ele é publicado uma vez e funciona com tanto o Terraform quanto o OpenTofu da mesma fonte; o HCL é idêntico, só o binário da CLI (terraform ou tofu) e o registro diferem. Em todo lugar abaixo, use o que você roda.

Acune um token de acesso

O provedor lê seu token da variável de ambiente CAPUTCHIN_MANAGEMENT_TOKEN (recomendado, para que fique fora do código-fonte). Qualquer tipo de token funciona (veja autenticação na API): um token de acesso pessoal para infraestrutura de conta inteira, ou um token de acesso de equipe delimitado às equipes que sua configuração gerencia.

export CAPUTCHIN_MANAGEMENT_TOKEN=cpt_pat_...

Há um caso de ovo e galinha: o provedor também consegue acunhar tokens (os recursos caputchin_account_token e caputchin_troop_pat), mas ele precisa de um token para se autenticar antes de tudo. Acune o primeiro na mão no painel, depois deixe o Terraform gerenciar o resto.

Configure o provedor

terraform {
  required_providers {
    caputchin = {
      source  = "caputchin/caputchin"
      version = "~> 0.1"
    }
  }
}

# Token from CAPUTCHIN_MANAGEMENT_TOKEN; endpoint defaults to https://caputchin.com/api.
provider "caputchin" {}

O mesmo source = "caputchin/caputchin" resolve do Terraform Registry e do OpenTofu Registry, então o bloco é o mesmo sob qualquer ferramenta.

Um exemplo prático: uma equipe com uma chave de site protegida

Isto cria uma equipe, uma chave de site nela, e liga o portão de jogo para essa chave:

resource "caputchin_troop" "shop" {
  name = "shop-team"
}

resource "caputchin_site_key" "shop_frontend" {
  name     = "shop-frontend"
  troop_id = caputchin_troop.shop.id
}

resource "caputchin_site_security_settings" "shop_frontend" {
  site_id      = caputchin_site_key.shop_frontend.id
  require_game = true
}

# The public key is an attribute; the secret is sensitive, in state only.
output "shop_site_key" {
  value = caputchin_site_key.shop_frontend.key
}

Depois, com qualquer ferramenta:

terraform init && terraform apply
# or
tofu init && tofu apply

O secret da chave de site é um atributo computado sensível; leia-o do state (terraform output) para configurar sua verificação no backend. Todo apply é atribuído ao seu token no registro de auditoria no Apex, então uma mudança pelo Terraform é tão rastreável quanto uma edição no painel.

O que você pode gerenciar

Os recursos cobrem a mesma superfície do painel: equipes e seus membros e tokens, chaves de site, configurações de segurança, verificação hospedada, personalização de jogo e white-label, e tokens de conta. As data sources deixam você ler equipes, sites, informações de conta e estatísticas existentes para dentro de uma configuração.

A referência completa

Cada recurso e data source, com todos os seus argumentos e atributos e a sintaxe de import, está na página do provedor no registro. Ela é gerada da fonte do provedor, então acompanha a versão lançada exatamente:

Terraform Registry: registry.terraform.io/providers/caputchin/caputchin
OpenTofu Registry: search.opentofu.org/provider/caputchin/caputchin

Para as operações subjacentes que cada recurso realiza, veja a referência interativa da API.

Veja também

Gerencie o Caputchin pela API: a API HTTP em que o provedor se apoia.
Use o servidor MCP: a superfície de agente de IA.
Equipes e chaves de site: os recursos que você está gerenciando.