Identidad de la key

GET/me

No exige ningún scope: basta una key válida.

Sanity-check de la key: no exige ningún scope, basta que la key sea válida. Devuelve la identidad de la key (nunca su hash ni plaintext).

Respuestas

200

Identidad de la key autenticada.

dataMeobligatorio

Campos de Me

userIdstringobligatorio
keyIdstringobligatorio
namestringobligatorio: Etiqueta de la key elegida por el usuario al crearla.
prefixstringobligatorio: Primeros caracteres de la key (p. ej. sk_live_a3f9), lo único visible tras la creación.
scopesarray<string>obligatorio: Valores: tasks:readtasks:writeprojects:readprojects:write

401

Key ausente, malformada, inexistente, revocada, expirada o API deshabilitada (invalid_api_key, indistinguibles a propósito).

Códigos: invalid_api_key

429

Límite superado (rate_limited) — 60 req/min (ráfagas de 20) y 5.000 req/día por key. Reintentar tras Retry-After.

Códigos: rate_limited

Cabecera Retry-After: Segundos (enteros) a esperar antes de reintentar.

500

Error interno (internal_error). Cuerpo opaco a propósito; reintentar con backoff.

Códigos: internal_error

bash

curl 'https://system.secretar-ia.org/api/v1/me' \
  -H "Authorization: Bearer $SECRETARIA_API_KEY"

JSON

{
  "data": {
    "userId": "k1m8x2c5v9b3n7q0w4e6r1t8y2u5i3o9",
    "keyId": "n4r8t2w6y0u3i7o1p5a9s3d7f1g5h9j2",
    "name": "Script de informes",
    "prefix": "sk_live_a3f9",
    "scopes": [
      "tasks:read",
      "tasks:write",
      "projects:read"
    ]
  }
}