API keys

Gestiona las API keys. Solo desde el panel, para que una key filtrada no pueda crear otras.

Listar API keys

GET/v1/api-keysSolo desde el panel

Respuesta 200

data []

• idstringobligatorio
• namestringobligatorio
• prefixstringobligatorio
• createdAtstring (date-time)obligatorio
• revokedAtstring (date-time)

curl

curl "https://api.usecrier.com/v1/api-keys" \
  -H "Authorization: Bearer $CRIER_API_KEY"

Node

const res = await fetch('https://api.usecrier.com/v1/api-keys', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/api-keys",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Crear una API key

POST/v1/api-keysSolo desde el panel

Cuerpo

• namestringobligatorio

  máx. 60

Respuesta 201

data

• keyobjectobligatorio
  key

  • idstringobligatorio
  • namestringobligatorio
  • prefixstringobligatorio
  • createdAtstring (date-time)obligatorio
  • revokedAtstring (date-time)
• secretstringobligatorio

  La key completa; solo se muestra esta vez.

curl

curl -X POST "https://api.usecrier.com/v1/api-keys" \
  -H "Authorization: Bearer $CRIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production"
  }'

Node

const res = await fetch('https://api.usecrier.com/v1/api-keys', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "production"
  }),
});
const { data } = await res.json();

Python

import os, requests

res = requests.post(
    "https://api.usecrier.com/v1/api-keys",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
    json={
        "name": "production"
    },
)
data = res.json()["data"]

Revocar una API key

DELETE/v1/api-keys/{id}Solo desde el panel

Parámetros

• idstringobligatorio

Respuesta 204

Sin contenido

curl

curl -X DELETE "https://api.usecrier.com/v1/api-keys/key_2b4n6m" \
  -H "Authorization: Bearer $CRIER_API_KEY"

Node

await fetch('https://api.usecrier.com/v1/api-keys/key_2b4n6m', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});

Python

import os, requests

requests.delete(
    "https://api.usecrier.com/v1/api-keys/key_2b4n6m",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)