API REST

Construye sobre tus proyectos de Skimle

Un único endpoint por sentido —lectura o escritura— para cada recurso del proyecto. Autentícate con una clave de API propia de cada proyecto, envía una acción en JSON y recibe JSON de vuelta.

Empieza en tres pasos

De cero a tu primera llamada autenticada.

1

Crea una clave de API

Las claves de API se limitan a un único proyecto y a un único nivel de acceso (lectura o edición).

  1. 1. Abre la página de claves de API
  2. 2. Elige a qué proyecto debe acceder la clave y si el acceso es de lectura o de edición
  3. 3. Copia la clave: Skimle solo guarda su hash

Copia la clave de inmediato.

El valor completo de la clave se muestra una sola vez, al crearla. Una vez cierres el cuadro de diálogo, en nuestro lado solo queda el hash: una clave perdida hay que volver a emitirla.

2

Envía tu primera petición

Pasa la clave como token Bearer y la acción en el cuerpo JSON. Todos los endpoints reciben JSON y devuelven JSON.

curl -X POST https://app.skimle.com/api/skimle-read \
  -H "Authorization: Bearer skm_…r" \
  -H "Content-Type: application/json" \
  -d '{ "action": "get_categories" }'

Las claves de lectura terminan en r y solo pueden llamar a /api/skimle-read. Las de edición terminan en e y pueden llamar a ambos endpoints.

3

Abre la referencia de la API

Recorre todos los endpoints con descripciones, la forma de las peticiones y un panel para probarlos. Cada ruta acepta un cuerpo de unión discriminada según la clave action.

La especificación OpenAPI 3.1 en bruto está disponible en /api/openapi.json.

¿Listo para construir?

Gestiona las claves de tus proyectos o echa un vistazo al servidor MCP para clientes agénticos.