Criar chave · API

POST/api/v1/orgs/{orgId}/projects/{projectId}/keys

Exige Authorization: Bearer com um access token.

curl -X POST "https://api.onny.space/api/v1/orgs/<orgId>/projects/<projectId>/keys" \
  -H "Authorization: Bearer $ONNY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Meu projeto"}'

POSTapi.onny.space/api/v1/orgs/%7BorgId%7D/projects/%7BprojectId%7D/keys

Access tokenorgId caminho · uuid · obrigatórioprojectId caminho · uuid · obrigatórioCorpo application/json

{
  "name": "Meu projeto"
}

Envie a requisição para ver status, tempo e corpo da resposta.

Parâmetros de caminho

orgIduuidobrigatório
projectIduuidobrigatório

Corpo da requisição application/json

namestringobrigatório
Nome para reconhecer a chave (ex.: "Servidor de produção").
máx. 80

Respostas

200OK

{
  "key": {
    "id": "texto",
    "name": "Meu projeto",
    "display": "texto",
    "createdBy": "texto",
    "createdAt": "2026-10-11T12:00:00+00:00",
    "lastUsedAt": "2026-10-11T12:00:00+00:00"
  },
  "secret": "texto"
}

2 campos descrição de cada um

keyobject
A chave.
- idstring
  Id público da chave (parte do valor).
- namestring
  Nome.
- displaystring
  Como a chave aparece: onny_live_<id>_…
- createdBystring | null
  Quem criou.
- createdAtdatetime
  Criada em.
- lastUsedAtdatetime | null
  Último uso (aproximado, atualizado no máximo a cada 30 s).
secretstring
Valor completo, mostrado só agora. Envie no cabeçalho X-Onny-Api-Key.

400Bad Request

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "auth.invalid / validation",
  "status": 400,
  "detail": "Mensagem legível para pessoas.",
  "code": "auth.invalid / validation",
  "traceId": "00-4bf9…-01"
}

401Unauthorized

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Mensagem legível para pessoas.",
  "code": "Unauthorized",
  "traceId": "00-4bf9…-01"
}

403Forbidden

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "error",
  "status": 403,
  "detail": "Mensagem legível para pessoas.",
  "code": "error",
  "traceId": "00-4bf9…-01"
}

404Not Found

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "error",
  "status": 404,
  "detail": "Mensagem legível para pessoas.",
  "code": "error",
  "traceId": "00-4bf9…-01"
}

409Conflict

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "error",
  "status": 409,
  "detail": "Mensagem legível para pessoas.",
  "code": "error",
  "traceId": "00-4bf9…-01"
}

{ "key": { "id": "texto", "name": "Meu projeto", "display": "texto", "createdBy": "texto", "createdAt": "2026-10-11T12:00:00+00:00", "lastUsedAt": "2026-10-11T12:00:00+00:00" }, "secret": "texto" }

{ "type": "https://tools.ietf.org/html/rfc9110", "title": "auth.invalid / validation", "status": 400, "detail": "Mensagem legível para pessoas.", "code": "auth.invalid / validation", "traceId": "00-4bf9…-01" }