Linework Developers
ES
Obtener acceso

Conceptos

Scopes

Los scopes determinan qué puede hacer una clave. Elígelos al crear la clave y dale a cada una solo lo que necesita.

Una solicitud a un endpoint cuyo scope no tiene la clave falla con 403 INSUFFICIENT_SCOPE. No se pueden añadir scopes a una clave existente: crea una clave nueva y revoca la antigua.

No disponible: pagos, wallet, tokens, transferencias y ajustes de la cuenta. Ningún scope da acceso a ellos.

Todos los scopes#

ScopePermite
profile:readLeer tu perfil y los perfiles públicos de otros usuarios.
posts:readLeer posts (los tuyos y los que puedes ver en la aplicación) y sus comentarios.
posts:writeSubir contenido multimedia, publicar, editar y eliminar tus posts.
comments:writeEscribir comentarios y eliminar tus comentarios (o los comentarios en tus posts).
likes:writeDar y quitar me gusta a posts.
follows:writeSeguir y dejar de seguir a usuarios.
stories:writePublicar historias.
store:readLeer tu tienda Bloop y sus productos.
store:writeEditar tu tienda; crear, actualizar y eliminar productos; actualizar el stock.
orders:readLeer los pedidos recibidos por tu tienda.
orders:writeMarcar pedidos como enviados.
chat:readLeer tus conversaciones y sus mensajes.
chat:writeEnviar mensajes (con la regla antispam).

Endpoints por scope#

Todas las rutas son relativas a https://api.linework.app/open/v1.

EndpointScope
GET /meprofile:read
GET /users/{id}profile:read
GET /users/by-username/{username}profile:read
GET /me/postsposts:read
GET /users/{id}/postsposts:read
GET /posts/{id}posts:read
GET /posts/{id}/commentsposts:read
POST /mediaposts:write, stories:write o store:write
POST /postsposts:write
PATCH /posts/{id}posts:write
DELETE /posts/{id}posts:write
POST /posts/{id}/commentscomments:write
DELETE /comments/{id}comments:write
POST DELETE /posts/{id}/likelikes:write
POST DELETE /users/{id}/followfollows:write
POST /storiesstories:write
GET /storestore:read
POST PATCH /storestore:write
GET /store/productsstore:read
POST /store/productsstore:write
PATCH DELETE /store/products/{id}store:write
PATCH /store/products/{id}/stockstore:write
GET /store/ordersorders:read
GET /store/orders/{id}orders:read
POST /store/orders/{id}/shiporders:write
GET /conversationschat:read
GET /conversations/{id}/messageschat:read
POST /conversations/{id}/messageschat:write
POST /messageschat:write

La Referencia de la API es la fuente de verdad: cada operación indica el scope que requiere.

Combinaciones recomendadas#

IntegraciónScopes
Bot de publicaciónprofile:read posts:read posts:write stories:write
Gestión de comunidadposts:read comments:write likes:write
Sincronización de la tiendastore:read store:write orders:read orders:write
Bot de chat de soportechat:read chat:write (+ orders:read para consultar pedidos)