ClaixClaixEnglish

Documentación API

Endpoints de schemas

Consulta, crea y elimina schemas de tu cuenta con la misma API key de extracción.

Schemas · Eliminar

Eliminar un schema por API

Endpoint

POSThttps://www.claix.dev/api/delete-schema

Borra un schema de la cuenta asociada a la API key. Solo elimina schemas que te pertenecen: si el UUID no existe o es de otra cuenta, responde 404 sin revelar si existe.

Llama siempre a https://www.claix.dev/api/delete-schema. No uses la URL interna de Supabase (https://yuhcusjiywsuzjwirarw.supabase.co/functions/v1/delete-schema).

La operación es irreversible. No se factura (no escribe en usage_logs).

1. Autenticación

Toda petición debe incluir tu API key. Es una credencial de servidor personal, distinta de cualquier token de sesión.

Opción A — Header dedicado (recomendado):

x-api-key: <TU_API_KEY>

Opción B — Header estándar Authorization:

Authorization: Bearer <TU_API_KEY>

Con uno de los dos es suficiente. Si envías ambos, x-api-key tiene prioridad.

El sistema valida que la key exista, esté activa y la cuenta no esté suspendida. Si falla, responde 401.

2. Formato de la petición

Método: POST (también se admite DELETE) · Content-Type: application/json

CampoTipoObligatorioDescripción
schema_iduuidSíIdentificador del schema a borrar. También se acepta id o ?schema_id= en la query.
{ "schema_id": "b980cfe7-61ef-4a5a-9724-881c8a5541e2" }

3. Cómo construir la llamada

  1. Obtén el id con GET /api/schemas.
  2. Construye un POST JSON a https://www.claix.dev/api/delete-schema.
  3. Añade el header de autenticación y el schema_id.
  4. Comprueba el código HTTP: solo 200 indica que se borró.

4. Ejemplos de llamada

Consulta el panel de la derecha para ver ejemplos en cURL, JavaScript, Node.js, Python, PHP y n8n.

5. Formato de la respuesta exitosa

200 OK · Content-Type: application/json

{
  "success": true,
  "deleted": true,
  "id": "b980cfe7-61ef-4a5a-9724-881c8a5541e2"
}
CampoTipoDescripción
successbooleanSiempre true cuando el HTTP es 200.
deletedbooleanConfirma que el schema se eliminó.
iduuidUUID del schema borrado.

6. Códigos de error

{
  "error": "Descripción legible del problema.",
  "detalle": "Información técnica adicional (solo presente en algunos casos)."
}

400 — Falta schema_id o no es un UUID válido.

401 — Autenticación fallida: key ausente, inexistente, desactivada o cuenta suspendida.

404 — El schema no existe o no pertenece a tu cuenta.

405 — Método distinto de POST o DELETE. · 500 — Error interno.

7. Resumen de códigos

CódigoCategoría¿Reintentar?
200Éxito—
400Error del cliente (datos mal formados)No, corrige la petición primero
401Error de autenticaciónNo, corrige las credenciales primero
404Recurso no encontradoNo, corrige el schema_id primero
405Método HTTP incorrectoNo, corrige el método primero
500Error interno del servidorSí, con precaución

8. Buenas prácticas

  • Usa https://www.claix.dev/api/delete-schema, nunca la URL de Supabase.
  • La eliminación es permanente; confirma el UUID antes de llamar.
  • Un 404 no distingue “no existe” de “no es tuyo”, a propósito.
  • No incluyas tu API key en frontend ni repositorios públicos.

Ejemplos de petición

curl -X POST "https://www.claix.dev/api/delete-schema" \
  -H "x-api-key: <TU_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{ "schema_id": "b980cfe7-61ef-4a5a-9724-881c8a5541e2" }'