Notificaciones
La bandeja, ya resuelta.
Cada notificación llega con su autor y con path, adónde apunta.
Resolverlo solía ser trabajo de quien lee: once lecturas encadenadas,
porque la dirección de una respuesta es la dirección de lo que
responde más un ancla. Es un join, y ocurre donde están los joins.
Los avisos del propio sistema, los de moderación y los de Arcade,
llegan con actor null: nunca dicen qué persona del equipo actuó.
path viene sin el prefijo de idioma (es de quien lee), y viene
null cuando ya no hay adónde ir.
/api/La bandeja, las más recientes primero, con las preferencias al lado. Cada elemento trae path: adónde apunta, sin el prefijo de idioma, que es de quien lee y no de la notificación. Viene null cuando ya no hay adónde ir (la publicación desapareció, o quien lee ya no puede verla) y entonces las palabras quedan sin enlace, en vez de apuntar a una página que las rechazaría. actor viene null en los avisos del propio sistema, los de moderación y los de Arcade: nunca dicen qué persona del equipo actuó.
Parámetros
| Campo | Tipo | Notas |
|---|---|---|
limit | integer | Cuántas traer, de 1 a 100. Por defecto 40. |
Ejemplo
{
"data": [
{
"id": "...",
"kind": "post_comment",
"created_at": "2026-09-05T18:00:00.000Z",
"read_at": null,
"target_title": "Hollow Knight",
"actor": { "username": "ada", "display_name": "Ada", "avatar_url": null },
"path": "review/aB3xY#comment-9kQ2",
"is_reply": true
}
],
"preferences": { "follows_enabled": true, "comments_enabled": true }
}/api/Marca como leído todo lo que está sin leer.
/api/Marca una como leída. Hacerlo dos veces no mueve la hora: la segunda llamada responde con lo que escribió la primera.
/api/Enciende y apaga lo que merece un aviso. Envía solo lo que cambia.
Cuerpo
| Campo | Tipo | Notas |
|---|---|---|
follows_enabled | boolean | Verdadero para recibir, falso para no. |
review_likes_enabled | boolean | Verdadero para recibir, falso para no. |
list_likes_enabled | boolean | Verdadero para recibir, falso para no. |
comments_enabled | boolean | Verdadero para recibir, falso para no. |
screenshots_enabled | boolean | Verdadero para recibir, falso para no. |
journal_likes_enabled | boolean | Verdadero para recibir, falso para no. |
/api/Los navegadores registrados para recibir push, del más reciente al más antiguo.
/api/Registra un navegador. Volver a suscribirse en el mismo navegador devuelve el mismo endpoint, así que repetir actualiza el registro en vez de crear otro; un endpoint que ya es de otra cuenta responde 409.
Cuerpo
| Campo | Tipo | Notas |
|---|---|---|
endpointobligatorio | string | La dirección que el servicio de push dio a este navegador. |
p256dhobligatorio | string | La clave pública de la suscripción. |
authobligatorio | string | El secreto de autenticación de la suscripción. |
device_label | string | Un nombre corto, solo para reconocer el dispositivo en la lista. |
/api/Olvida un dispositivo. Su navegador sigue suscrito al servicio de push hasta que se dé de baja, lo que solo él puede hacer.