用途:面向 Graphistry Hub REST 端点的操作技能,涵盖 JWT 认证、上传、图 URL 控制、会话与令牌安全分享。默认不执行 shell 命令、不查本地仓库,直接依据端点映射与模板作答;仅在用户明确要求源码级证据时才检查本地文件。
主要能力与端点:认证包括 /api-token-auth/、/api-token-refresh/、/api-token-verify/、/api/v2/auth/pkey/jwt/;上传生命周期为 /api/v2/files/、/api/v2/upload/files/、/api/v2/upload/datasets/;数据集为 /api/v2/datasets/?limit=100 与 /api/v2/datasets/{dataset_id}/;单次网关为 GET /api/v2/generate/single-use-url/?username=<username>&dataset_id=<dataset_id>,撤销用 GET /api/v2/logout-user/username/<username>/;会话为 /api/experimental/viz/sessions/ 及其 {session_id};命名端点为 /api/v2/o/<org>/functions/{gfql|python}/ 与 /api/v2/o/<org>/run/{gfql|python}/;健康检查含 /healthcheck/、/ht/、/healthz 及 streamgl 系列。
使用方式:认证示例用环境变量导出 GRAPHISTRY_HOST、GRAPHISTRY_USERNAME、GRAPHISTRY_PASSWORD,再 POST /api-token-auth/ 取 token,后续请求带 Authorization: Bearer。上传数据集时在 /api/v2/upload/datasets/ 提交 metadata(无自定义时用 {})、node_encodings.bindings 与 edge_encodings.bindings。渲染 URL 形如 https://hub.graphistry.com/graph/graph.html?dataset=<dataset_id>,可加 &play=0、&linLog=true 等参数;collections 需为 URL 编码的 JSON 数组并先去空白。
适用场景:curl 调用 Graphistry API、获取 JWT、上传文件与数据集、控制图 URL、会话分享、健康检查与文件清理排查。
限制:令牌只放请求头,禁止放入 URL 参数;不得编造 /api/v2/query、/api/v2/graphql、/api/v2/gfql/query 等未文档化端点;无公开的 REST 列用户端点,需走管理员/IDP 流程;/api/v2/share/link/ 等路由为部署暴露,可用性需在目标租户验证;部分健康检查属部署/管理员范围,托管租户可能不开放;SDK/GFQL 的临时查询不属通用 REST 端点。