Neuigkeiten Auto app updates, a week of requests, and crypto donations

API server

Requests

Anyone can ask for a patch and vote on what others asked for. There are no accounts: a browser gets an anonymous voter token once, after a Cloudflare Turnstile check, and keeps it. Requests go live when posted.

Requests need REQUESTS_SECRET and TURNSTILE_SECRET; see Configuration.

Voter tokens

curl -X POST https://api.reseam.app/v1/voters \
  -H "Content-Type: application/json" \
  -d '{ "turnstile": "<token from the Turnstile widget>" }'

The answer is 201 with { "token": "..." }. Send it as Authorization: Bearer <token> to post, vote, comment, and report. The server stores only its hash. One address gets at most 20 tokens an hour.

GET /v1/voters/me returns { requests, votes, comments }: the ids of the requests this token posted and voted on, and of the comments it wrote.

List

GET /v1/requests returns every request that isn't hidden.

Query
app package name
status open, shipped, closed, or hidden (admins)
sort top (default, most votes first), new, or priority (high, medium, low, then unset; most votes first within each)
q words that must all appear in the title or body

A request has id, app (package name or null), title, body, status, priority (high, medium, low, or null), shipped_in (for example [email protected]), duplicate_of (set on a closed duplicate), votes, comments (how many are visible), and created_at. With the admin token, the list includes hidden requests.

Post

curl -X POST https://api.reseam.app/v1/requests \
  -H "Authorization: Bearer $VOTER" \
  -H "Content-Type: application/json" \
  -d '{ "app": "com.example.app", "title": "Add a dark theme", "body": "The settings screen stays white at night." }'
Field
title 10 to 100 characters
body up to 1000 characters
app package name, optional
force post even though it looks like an open request

One token posts at most 3 requests a day, one address at most 10.

Screening

With OPENROUTER_API_KEY set, each new request is checked by a decision model on OpenRouter (SCREENING_MODEL, Drex Max by default) before it is stored:

  • Spam. Spam, ads, abuse, and anything that isn't a request are stored as hidden.
  • Duplicates. If it asks for the same thing as an open, shipped, or closed request that isn't itself a duplicate, the answer is 409 with that request as duplicate. Vote on it, or send the request again with force: true.
  • App. A request without app gets the package of the app it is about, when the model is confident.

The model sees the new request's title and body, and the title and body of every open, shipped, and closed request that isn't a duplicate, for the same app or for no app (every app's, when the new one names none). If it can't be reached, the request is posted without screening. Comments get the spam check too, with their request's title and body as context.

Votes and reports

PUT /v1/requests/<id>/vote votes and DELETE takes the vote back. Both return { votes }. One token votes once per request; one address casts at most 3 votes per request a day.

POST /v1/requests/<id>/report reports a request. Once 3 voters from at least 2 addresses reported it, it becomes hidden.

Comments

curl -X POST https://api.reseam.app/v1/requests/12/comments \
  -H "Authorization: Bearer $VOTER" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Does it need to work in the mini player too?" }'

GET /v1/requests/<id>/comments lists a request's comments, oldest first. A comment has id, request_id, body, team, requester (written by whoever posted the request), hidden, and created_at. A comment posted with the admin token is team: true and skips the limits and screening.

body is 1 to 1000 characters. One token comments at most 30 times a day, one address at most 100. A comment that screening flags as spam is stored with hidden: true.

POST /v1/comments/<id>/report reports a comment and hides it the same way as a request. DELETE /v1/comments/<id> deletes a comment, sent by its author or with the admin token.

Moderate

With the admin token:

curl -X PATCH https://api.reseam.app/v1/requests/12 \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "status": "shipped", "shipped_in": "[email protected]" }'

PATCH takes status, priority, shipped_in, duplicate_of, title, and app. Setting status back to open restores a hidden request.

PATCH /v1/comments/<id> with { "hidden": true } or false hides or shows a comment. With the admin token, the comment list includes hidden comments.

DELETE /v1/requests/<id> deletes one request. DELETE /v1/requests/<id>?author=true deletes its author's token and everything that token posted, commented, voted, and reported.

Next: Translate.

Diese Seite bearbeiten