Resgatar código de presente

curl

curl -X POST https://app.cubehosting.com.br/api/account/gift-codes/redeem \
  -H "Authorization: Bearer $CUBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"CUBE-7K2P-9QWE-4RTY"}'

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/account/gift-codes/redeem`, {
  method: 'POST',
  headers: { ...headers, 'Content-Type': 'application/json' },
  body: JSON.stringify({ code: process.env.GIFT_CODE }),
});
const { gift, account } = await res.json();
console.log(gift.summary, account.plan);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.post(
    f"{API}/account/gift-codes/redeem",
    headers=headers,
    json={"code": os.environ["GIFT_CODE"]},
    timeout=30,
)
r.raise_for_status()
print(r.json()["gift"]["summary"])

{
  "gift": {
    "code": {
      "plan": "stack",
      "days": 30
    },
    "kind": "days_converted",
    "plan": "monolith",
    "days": 3,
    "endsAt": null,
    "returnsToPlan": null,
    "previousPaidUntil": "2026-10-20T15:00:00.000Z",
    "paidUntil": "2026-10-23T15:00:00.000Z",
    "summary": "Este código vale 3 dias do seu plano Monolith (30 dias de Stack pelo valor). O vencimento passa de 20/10/2026 para 23/10/2026."
  },
  "account": {
    "id": "0f1e2d3c-aaaa-4bbb-8ccc-000000000001",
    "plan": "monolith",
    "gift": null
  }
}

POST

account

gift-codes

redeem

curl

curl -X POST https://app.cubehosting.com.br/api/account/gift-codes/redeem \
  -H "Authorization: Bearer $CUBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"CUBE-7K2P-9QWE-4RTY"}'

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/account/gift-codes/redeem`, {
  method: 'POST',
  headers: { ...headers, 'Content-Type': 'application/json' },
  body: JSON.stringify({ code: process.env.GIFT_CODE }),
});
const { gift, account } = await res.json();
console.log(gift.summary, account.plan);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.post(
    f"{API}/account/gift-codes/redeem",
    headers=headers,
    json={"code": os.environ["GIFT_CODE"]},
    timeout=30,
)
r.raise_for_status()
print(r.json()["gift"]["summary"])

{
  "gift": {
    "code": {
      "plan": "stack",
      "days": 30
    },
    "kind": "days_converted",
    "plan": "monolith",
    "days": 3,
    "endsAt": null,
    "returnsToPlan": null,
    "previousPaidUntil": "2026-10-20T15:00:00.000Z",
    "paidUntil": "2026-10-23T15:00:00.000Z",
    "summary": "Este código vale 3 dias do seu plano Monolith (30 dias de Stack pelo valor). O vencimento passa de 20/10/2026 para 23/10/2026."
  },
  "account": {
    "id": "0f1e2d3c-aaaa-4bbb-8ccc-000000000001",
    "plan": "monolith",
    "gift": null
  }
}

Resgata o código na sua conta e devolve o que ele fez (gift) e a conta com o plano de agora (account). Cada código vale uma vez, e a conta tem um presente por vez. Pede uma chave de leitura e escrita criada na própria conta: a de uma equipe não resgata. Veja antes com a Prévia; as regras estão em Códigos de presente.

Erros comuns

Código	HTTP	O que fazer
`invalid_gift_code`	400	Confira o código: a resposta é a mesma para um código que não existe.
`gift_code_used`	410	Cada código vale uma vez: peça outro a quem deu o presente.
`gift_code_expired`	410	O prazo de resgate acabou: peça outro código.
`gift_already_active`	409	A conta já tem um presente: resgate depois da data na `message`.
`plan_without_cycle`	409	O plano liberado não tem vencimento: só um código de plano maior vale.
`api_key_not_allowed`	403	Use uma chave criada na sua conta, não numa equipe.
`too_many_attempts`	429	Espere o `Retry-After`: são 10 tentativas a cada 15 minutos.

Todos os códigos, com o formato do erro, em Códigos de erro.

Autorizações

Authorization

string

header

obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_….

Corpo

application/json

code

string

obrigatório

O código de presente, como CUBE-XXXX-XXXX-XXXX (minúsculas, espaços e hífens são aceitos).

Maximum string length: 40

Resposta

Resgatado: o que o código fez e a conta com o plano de agora.

gift

object

obrigatório

Show child attributes

account

object

obrigatório

A conta depois do resgate: plan e gift ({ endsAt, returnsToPlan } com o plano do presente por cima).

Visão geral

Projetos

Templates

Controle

Logs e métricas

Análise

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Domínios

Avisos

Conta

Resgatar código de presente

Erros comuns

Autorizações

Corpo

Resposta

​Erros comuns

Autorizações

Corpo

Resposta

Erros comuns