SuperAPI AI 工具集

snapas

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:该技能为 Snap.as API 开发提供帮助,用于构建上传照片到 Snap.as、管理照片、调试请求、开发相册及组织级照片上传等场景,属于 Write.as 套件中的图片服务。

主要能力:提供认证方式、各端点调用、响应结构与错误处理参考。所有请求基于 https://snap.as,需在 Authorization 头携带 Write.as 用户访问令牌,格式为 Authorization: Token 00000000-0000-0000-0000-000000000000。

必要用法:个人上传:curl https://snap.as/api/photos/upload -H "Authorization: Token YOUR_ACCESS_TOKEN" -F "file=@/path/to/photo.jpg",成功返回 201 及 id、filename、size、url。获取用户照片:curl -X POST https://snap.as/api/me/photos -H "Authorization: Token YOUR_ACCESS_TOKEN"。删除照片:curl -X POST https://snap.as/api/photos/abc123 -H "Authorization: Token YOUR_ACCESS_TOKEN"。组织上传:curl https://snap.as/api/organizations/myorg/photos/upload。Go 客户端:import "github.com/snapas/go-snapas",使用 snapas.NewClient("YOUR_ACCESS_TOKEN") 与 client.UploadPhoto("/path/to/photo.jpg")。

成功响应为 {"code":...,"data":...},失败为 {"code":...,"error_msg":...}。状态码包括 200、201、400、401、403、404、429。

限制:需 Write.as 访问令牌;组织功能需相应权限;上传使用 multipart/form-data;可能存在速率限制(429 需重试退避);照片经返回 URL 公开可访问;支持格式与大小限制、价格与平台未在资料中明确说明。