10分钟跑通 Casdoor API：从拿到令牌到完成一次用户增删改查

10分钟跑通 Casdoor API从拿到令牌到完成一次用户增删改查【免费下载链接】casdoorAn open-source Agent-first Identity and Access Management (IAM) /LLM MCP agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Face ID, Google Workspace, Azure AD项目地址: https://gitcode.com/gh_mirrors/ca/casdoor跟着本文走完你就能在本地起一个 Casdoor用 curl 拿到访问令牌再靠它跑通一次完整的用户增删改查——不读源码、不装 SDK全程几条命令。先跑起来起一个 Casdoor 并拿到第一张令牌 这一步只追求一个目标让服务活起来并攥住第一张能换数据的令牌。不装数据库也不写配置文件一条命令就能用 SQLite 加示例数据把 Casdoor 跑起来docker run -p 8000:8000 casbin/casdoor-all-in-one浏览器打开http://localhost:8000用组织built-in、用户名admin、密码123登录登录框里组织和用户名是分开的两个输入框。登录页只是验证服务正常真正调 API 需要走/api/login拿令牌把返回的data存下来后面每一步都用它curl -X POST http://localhost:8000/api/login \ -H Content-Type: application/json \ -d {type:login,application:app-built-in,organization:built-in,username:admin,password:123}返回体里status为okdata字段就是 accessToken一串 JWTdata2是 refreshToken。把它复制出来下文用accessToken代指。核心流程串起来做一次用户增删改查拿到令牌后所有请求都只需带上Authorization: Bearer accessToken。这里挑一条最典型的主线先查有哪些用户再新建一个最后改它的字段。查列表。GET /api/get-users用owner参数圈定组织返回该组织下的用户数组curl http://localhost:8000/api/get-users?ownerbuilt-in \ -H Authorization: Bearer accessToken响应是{status:ok,data:[{...},{...}]}data里每个对象都带id形如built-in/admin、name、displayName等字段记下id的格式——更新和删除都要靠它。建用户。POST /api/add-user请求体只填必要字段owner必须等于令牌所属组织curl -X POST http://localhost:8000/api/add-user \ -H Content-Type: application/json \ -H Authorization: Bearer accessToken \ -d {owner:built-in,name:alice,password:123,displayName:Alice,email:aliceexample.com}成功后data是新建的完整用户对象id为built-in/alice。改字段。POST /api/update-user只提交要改的字段加一个id来定位返回更新后的用户curl -X POST http://localhost:8000/api/update-user \ -H Content-Type: application/json \ -H Authorization: Bearer accessToken \ -d {id:built-in/alice,displayName:Alice W.}删用户。POST /api/delete-userbody 传{id:built-in/alice}status变ok即删成功。至此查、增、改、删四个动作你都已经亲手跑过。自助查文档不靠记学会自己找到接口接口太多背不住关键是把找接口这件事变成套路下面三个入口覆盖 99% 的场景。在线文档最常用。服务起好后直接访问http://localhost:8000/swagger左侧按User API、Organization API分组列出全部接口点开就能看参数、填请求体、点 Try it out 直接发请求等于把 curl 搬进了网页。本地文档文件。想离线看或塞进自己的文档站直接打开 swagger/swagger.json。它是按 OpenAPI 规范生成的paths下每条路径对应一个接口如/api/add-user的postdefinitions下object.User这类定义了请求/响应的字段结构。看不懂某个字段时去definitions里搜它引用的模型名即可。顺着源码找路由。所有 URL 与方法的映射集中在 routers/router.go每行web.Router(/api/xxx, ...)就是一个接口想确认某个功能到底走哪个方法看这一份就够了。具体实现散在 controllers/user.go、controllers/auth.go 等文件里方法上方的Title、Param注解就是接口说明的来源。一页速查表接口路径方法用途关键参数/api/loginPOST登录并获取令牌organization,username,password,type/api/get-usersGET查用户列表owner组织名/api/get-userGET查单个用户id/api/add-userPOST新建用户owner,name,password/api/update-userPOST改用户字段id 要改的字段/api/delete-userPOST删除用户id/api/get-organizationsGET查组织列表-/api/get-applicationsGET查应用列表owner完整清单以 swagger/swagger.json 为准表里只是最常用的几行。常见坑与 FAQ401 / 令牌无效。多半是Authorization头没写对前缀固定是Bearer首字母大写空格隔开令牌或者令牌已过期。重新走一遍/api/login换新令牌并留意它带有效期。返回Unauthorized operation。令牌有效但权限不够——写操作要求你是对应组织的管理员且owner要与令牌所属组织一致。换成built-in/admin这类管理员令牌再试。add-user报字段错误。请求体里owner和name不能少且要和你登录的组织对得上缺字段时 Casdoor 会给出msg说明照着补就行。curl 改了却没生效。确认update-user/delete-user带上了idbuilt-in/用户名且方法是 POST 不是 GETstatus为ok才算成功。本地调试 404。确认服务用的是http://localhost:8000端口且访问的是/api/前缀路径别把前端页面路径当成 API。跑通这条主线后剩下的接口都是同一套带令牌 拼参数的组合照 swagger/swagger.json 现查即可路由与实现可在 routers/router.go、controllers/ 里随时对照。【免费下载链接】casdoorAn open-source Agent-first Identity and Access Management (IAM) /LLM MCP agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Face ID, Google Workspace, Azure AD项目地址: https://gitcode.com/gh_mirrors/ca/casdoor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考