---
title: "解析共享邀请链接 token"
method: POST
path: "/auth/invitations/lookup"
tags: ["认证"]
---

# 解析共享邀请链接 token

`POST /auth/invitations/lookup`

根据邀请链接中的 token 返回邀请上下文（空间名 / 角色 / 过期时间），
供注册页展示。无认证；token 无效或被撤销返回 410。
使用 POST + body 而非 GET + path，避免 token 落入访问日志 / 浏览器历史 / tracing。

## Request body

- InternalHandlerInvitationLookupRequest
  - `token` string, required

## Response `200`

OK

- InternalHandlerInvitationLookupResponse
  - `expires_at` string
  - `role` 'owner' | 'admin' | 'contributor' | 'viewer'
  - `tenant_id` integer
  - `tenant_name` string

## Other responses

- `410` — 链接无效或已撤销

---

[API](https://skmtc.net/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.net/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/abce9036def5/schema)