Enlace a un registro¶

Cada registro que devuelve la API V2 incluye url: su enlace permanente en la aplicación web de Zinkee. Sirve para que una persona abra el registro desde tu integración, tu asistente de IA o un mensaje que envíes.

Lo devuelven:

GET /api/v2/schemas/{schemaId}/records/{recordId};
el listado y records:query, en cada registro de data;
PATCH /api/v2/schemas/{schemaId}/records/{recordId};
la creación, en createdRecords. Esa lista va en el mismo orden que created, que no cambia.

{
  "recordId": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://z2.zinkee.com/r/3f2b1c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d/2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e/550e8400-e29b-41d4-a716-446655440000",
  "values": {
    "name": "Rediseño de la web"
  }
}

{
  "created": ["550e8400-e29b-41d4-a716-446655440000"],
  "createdRecords": [
    {
      "recordId": "550e8400-e29b-41d4-a716-446655440000",
      "url": "https://z2.zinkee.com/r/3f2b1c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d/2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e/550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "errors": []
}

Cómo usarlo¶

Muestra o cita url tal cual. No lo construyas tú: la API ya pone el dominio de la aplicación y el identificador del workspace.
El enlace no da acceso. Quien lo abre tiene que iniciar sesión en Zinkee y ser miembro del workspace. Si no lo es, Zinkee no muestra ningún dato. Consulta Enlace a un registro.
Es permanente. Usa solo identificadores, así que no cambia aunque se renombre la tabla, su slug o el registro. Si el registro se borra, el enlace muestra que ya no existe.
Si una respuesta no trae url, no lo inventes. Muestra el registro sin enlace.

El formato es {aplicación}/r/{workspaceId}/{schemaId}/{recordId}, donde schemaId es siempre el de la tabla.