Què és un entitlement: producte, subscripció i accés en 3 capes
Què és un entitlement i com es diferencia d'un producte i d'una subscripció. Com comprovar l'accés d'un usuari a web, iOS i Android amb l'API de Cifrago.
Un entitlement és el permís que té un usuari per utilitzar una funció de la teva app, per exemple «pro». El producte és el que es ven i la subscripció és com es paga; l'entitlement és el que la teva app consulta per obrir o tancar la funció. Separar les tres capes permet vendre el mateix a la web, iOS i Android.
Nota: Cifrago està en fase final de desenvolupament i encara no admet nous comerços. L'API descrita aquí estarà disponible pròximament.
Producte, subscripció i entitlement
| Capa | Què és | Exemple |
|---|---|---|
| Producte / preu | El que es ven | «Pro anual» al web, «Pro mensual» a l'App Store |
| Subscripció o compra | Com i quan es paga | Renovació cada mes; estat actiu, past_due o caducada |
| Entitlement | El permís que l'app comprova | pro |
Diversos productes poden donar el mateix entitlement. Així, qui ha pagat al web i qui ha pagat a iOS veuen la mateixa funció desbloquejada.
Com comprovar l'accés amb l'API de Cifrago
| Endpoint | Què fa | Clau |
|---|---|---|
GET /api/v1/subscribers/{appUserId} | Retorna els entitlements actius (activeEntitlementKeys), les seves quantitats, les subscripcions i les compres en botigues. Si l'usuari no existeix, el crea | Pública o secreta |
POST /api/v1/receipts | Registra un rebut d'App Store o Google Play perquè l'accés sigui el mateix a totes les plataformes | Pública o secreta |
POST /api/v1/subscribers/{appUserId}/grants | Concedeix un entitlement promocional, amb caducitat opcional | Només secreta |
GET /api/v1/catalog i GET /api/v1/offerings | Productes, preus i ofertes de l'app | — |
A iOS i Android, les compres integrades a l'app passen obligatòriament per l'App Store o Google Play. Cifrago registra el rebut i manté el mateix permís arreu. El permís viu al servidor, no al mòbil. La clau pública només pot llegir el subscriptor i registrar compres; en qualsevol altre endpoint rep un 401.
Com es modela per dins
entitlements: els permisos de cada app (per exemple,pro).price_entitlements: quin preu dona quin permís.store_product_entitlements: quin producte d'App Store o Google Play dona quin permís.- Els consumibles (crèdits, paquets) es registren, però no donen entitlements.
Preguntes freqüents
Què és un entitlement?
És el permís que té un usuari per utilitzar una funció o contingut de la teva app, com ara «pro». El teu codi no pregunta «ha pagat aquest producte?», sinó «té aquest permís actiu?». Això simplifica el codi i permet vendre en diverses plataformes.
En què es diferencia d'una subscripció?
La subscripció és l'acord de pagament: preu, periodicitat i estat. L'entitlement és el resultat: mentre la subscripció estigui activa o en període de gràcia, l'usuari té el permís. Diverses subscripcions o compres diferents poden donar el mateix permís.
Com sap la meva app si l'usuari té accés?
Consultant GET /api/v1/subscribers/{appUserId} i comprovant si el permís és a activeEntitlementKeys. La resposta també inclou les subscripcions i les compres a les botigues, per si vols mostrar el detall a l'usuari.
Serveix per a compres d'App Store i Google Play?
Sí. L'app envia el rebut a POST /api/v1/receipts i Cifrago concedeix el mateix entitlement que donaria una compra al web. Així, un usuari que paga a l'iPhone també hi té accés des d'Android o des del navegador.
Estàs muntant subscripcions?
Mira les tarifes i prova el tauler amb dades d'exemple abans d'integrar res.