Review, publish, preview and undo changes through the API
Revisions now call publishing only what publishes: a project's status is whether the work is active, and a service is published by its flag. The fake identity server answers by token, so a test can sign in a second person. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
30
README.md
30
README.md
@@ -1302,6 +1302,36 @@ salen desactivados): sin `projects.publish` o `services.publish`, la API rechaza
|
||||
algo no puede sacarlo a la web solo. Las relaciones enviadas sustituyen a las
|
||||
que había, y las no enviadas no se tocan; todo se guarda en una transacción.
|
||||
|
||||
### Historial, revisión y vista previa
|
||||
|
||||
```
|
||||
GET /api/v1/{tipo}/{id}/revisions historial (páginas, categorías, proyectos,
|
||||
miembros, servicios, clientes, testimonios,
|
||||
charlas, tecnologías, convocatorias)
|
||||
POST /api/v1/revisions/{id}/restore deshacer lo que cambió una revisión
|
||||
GET /api/v1/reviews lo que espera mi revisión
|
||||
GET /api/v1/{tipo}/{id}/reviews el hilo (pages, projects, services)
|
||||
POST /api/v1/{tipo}/{id}/comments comentar
|
||||
POST /api/v1/{tipo}/{id}/review pedir revisión {reviewer_id?, note?}
|
||||
POST /api/v1/{tipo}/{id}/return devolver con motivo {note}
|
||||
POST /api/v1/{tipo}/{id}/publish aprobar: ya, o programado con {at}
|
||||
POST /api/v1/{tipo}/{id}/unpublish
|
||||
POST /api/v1/{tipo}/{id}/preview enlaces de vista previa por idioma
|
||||
```
|
||||
|
||||
Lo mismo que los botones del panel, con las mismas reglas: pedir revisión es
|
||||
para quien escribe sin `{tipo}.publish`, devolver y publicar son para quien lo
|
||||
tiene, y deshacer una revisión que tocó la publicación también lo pide.
|
||||
Programar una publicación responde la revisión en ese momento, no cuando llega
|
||||
la fecha: la decisión ya está tomada. Los enlaces de vista previa son los del
|
||||
panel —un registro, un idioma, unas horas— y [`AdminContent`](app/Support/AdminContent.php)
|
||||
es la tabla de qué tipo admite cada cosa, la que leen las rutas, los
|
||||
controladores y el historial.
|
||||
|
||||
El historial ahora llama «publicado» solo a lo que publica de verdad: cambiar
|
||||
el `status` de un proyecto (activo, en pausa) salía como publicación, y activar
|
||||
un servicio no.
|
||||
|
||||
Los ajustes siguen los permisos del panel: `settings.view` para leer,
|
||||
`settings.update` para cambiar y `settings.maintenance` para `site.maintenance`
|
||||
y `/v1/maintenance`. `content.version` lo escribe la aplicación y la API lo
|
||||
|
||||
Reference in New Issue
Block a user