API

Objetos

El objeto es la unidad de infraestructura. Se crea una vez, se instala en Apple Wallet o Google Wallet y desde ahí vive: cambia de estado, de campos y de mensajes sin reinstalarse.

POST /objects

curl -X POST https://api.gustto.dev/v1/objects \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: 7c1f0d2e-3a55" \
  -d '{
    "template_id": "tpl_university_id",
    "holder": { "name": "Camila Fernández", "external_id": "2026-44812" },
    "fields": { "program": "Ingeniería Civil", "valid_until": "2026-12-31" },
    "barcode": { "format": "qr", "value": "GUS-2026-44812" }
  }'

Objeto

{
  "id": "obj_8f21c4a9",
  "template_id": "tpl_university_id",
  "status": "active",
  "holder": {
    "name": "Camila Fernández",
    "external_id": "2026-44812"
  },
  "fields": {
    "program": "Ingeniería Civil",
    "valid_until": "2026-12-31",
    "access_level": "campus_full"
  },
  "barcode": { "format": "qr", "value": "GUS-2026-44812" },
  "platforms": { "apple": "installed", "google": "installed" },
  "created_at": "2026-01-14T18:04:11Z",
  "updated_at": "2026-03-02T09:41:56Z"
}

Método	Ruta	Descripción
POST	/objects	Crear un objeto y obtener su link de instalación
GET	/objects/:id	Leer el estado actual del objeto
PATCH	/objects/:id	Actualizar campos, estado o código
POST	/objects/:id/void	Anular la credencial en el teléfono
GET	/objects	Listar y filtrar por estado, plantilla o tenant