uploadMyNewsImage
为资讯条目上传横幅
multipart/form-data,带 file:JPEG、PNG 或 WebP。返回资讯条目在 banner_hash 中携带的哈希。横幅只能从这里获得:POST 与 PATCH /v2/me/news 会拒绝不是由本接口存入的哈希,因为挂在其他站点图床身份下的图片不会为资讯流续期。在当个 UTC 日内用满 catalog.news_image_uploads_per_day 的账号会被拒以 429 QUOTA_EXCEEDED。需要用户访问令牌。
post
/v2/me/news-imagesAuthorization: Bearer <用户访问令牌>(用户授权后的访问令牌,不是 API 密钥)参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
Idempotency-Key | string | header | 让请求可以安全重试。24 小时内同一把键配同一请求体,会带着 Idempotency-Replayed: true 重放第一次的响应;同一把键配不同请求体是 409 IDEMPOTENCY_KEY_REUSED;第一次请求还在处理时重试是 409 IDEMPOTENCY_REQUEST_IN_PROGRESS。范围限定为调用方与路径。 |
响应
请求示例
cURL
curl -X POST "https://api.nextmoe.dev/v2/me/news-images" \
-H "Authorization: Bearer <ACCESS_TOKEN>"