ByDomuDevelopers
Crear clave

Información de la API key

GEThttps://api.bydomu.com/v1/me

Devuelve la clave actual, la organización y los scopes. Sirve para comprobar que la clave es válida. rateLimit es un valor fijo histórico: el límite real de la clave llega en X-RateLimit-Limit.

Permiso
Cualquier clave válida
Claves
Publicable o secreta

Encabezados

X-API-Keystringobligatorio
Tu clave publicable o secreta.

Respuestas

200La clave, su organización y sus scopes
401UNAUTHORIZED · Clave faltante, inválida, desactivada o vencida.
403FORBIDDEN · La clave no puede usar esta operación: falta el scope, es una secreta en el navegador, el nivel de la cuenta no la permite, está suspendida o se alcanzó un tope del plan.
429RATE_LIMITED · Límite de peticiones excedido: el de la clave (`RATE_LIMITED`), el de escrituras de la organización (`TENANT_RATE_LIMITED`) o bloqueo temporal de la IP por claves inválidas.
500INTERNAL_ERROR · Error interno del servidor.
cURL
curl "https://api.bydomu.com/v1/me" \
  -H "X-API-Key: $BYDOMU_API_KEY"
JavaScript
const res = await fetch("https://api.bydomu.com/v1/me", {
  headers: { "X-API-Key": process.env.BYDOMU_API_KEY },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://api.bydomu.com/v1/me",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]}
)
data = r.json()
Respuesta · 200 · ejemplo
{
  "data": {
    "apiKeyId": "clx1key001",
    "organization": {
      "id": "clx1org001",
      "plan": "BUSINESS",
      "isActive": true
    },
    "rateLimit": {
      "limit": 1000,
      "window": "1 minute"
    },
    "scopes": [
      "portal:read"
    ],
    "legacyFullAccess": false
  }
}

La clave va en la variable BYDOMU_API_KEY. Los datos del ejemplo no son de ninguna inmobiliaria.