API
Lee y modifica tus datos de Solid con endpoints REST o GraphQL generados a partir de tu propio modelo de datos.
Solid genera su API a partir de tu modelo de datos. Los objetos personalizados obtienen los mismos endpoints que los estándar, con los nombres de tus propios objetos y campos.
Dos API
| API | Ruta | Úsala para |
|---|---|---|
| Core | /rest/ o /graphql/ | Crear, leer, actualizar y eliminar registros |
| Metadata | /rest/metadata/ o /metadata/ | Gestionar objetos, campos y ajustes del espacio de trabajo |
REST y GraphQL acceden a los mismos datos. GraphQL además obtiene registros relacionados en una sola llamada y admite upserts por lotes.
Autenticación
Envía una clave de API con cada solicitud:
Authorization: Bearer YOUR_API_KEYPara crear una clave:
- Ve a Configuración → API y Webhooks.
- Haz clic en + Crear clave y asígnale un nombre y una fecha de caducidad.
- Copia la clave de inmediato. Solo se muestra una vez.
Una clave de API da acceso a tus datos. Asígnale un rol limitado en Configuración → Miembros → Roles y elimínala en cuanto deje de ser necesaria.
Una primera solicitud
Lista las empresas con REST:
curl https://YOUR_SOLID_URL/rest/companies \
-H "Authorization: Bearer YOUR_API_KEY"Crea un registro en un objeto personalizado llamado Contracts:
curl -X POST https://YOUR_SOLID_URL/rest/contracts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Renovación Acme 2026"}'Sustituye YOUR_SOLID_URL por la dirección de tu espacio de trabajo.
La referencia de tu espacio de trabajo
Como la API sigue tu modelo de datos, su referencia completa se genera para cada espacio de trabajo. Abre Configuración → API y Webhooks, crea una clave y elige REST API o GraphQL API para explorar y probar cada endpoint en el playground.