Zer da entitlement bat: produktua, harpidetza eta sarbidea
Zer den entitlement bat eta zertan bereizten den produktu edo harpidetza batetik. Egiaztatu sarbidea web, iOS eta Androiden Cifragoren APIarekin.
Entitlement bat erabiltzaile batek zure aplikazioaren funtzio bat erabiltzeko duen baimena da, adibidez «pro». Produktua saltzen dena da eta harpidetza ordaintzeko modua; entitlement-a, berriz, zure aplikazioak funtzioa ireki edo ixteko kontsultatzen duena da. Hiru geruzak bereizteak gauza bera webean, iOSen eta Androiden saltzeko aukera ematen du.
Oharra: Cifrago garapenaren azken fasean dago eta oraindik ez du saltzaile berririk onartzen. Hemen deskribatzen den APIa laster egongo da eskuragarri.
Produktua, harpidetza eta entitlement-a
| Geruza | Zer den | Adibidea |
|---|---|---|
| Produktua / prezioa | Saltzen dena | «Urteko pro» webean, «Hileko pro» App Store-n |
| Harpidetza edo erosketa | Nola eta noiz ordaintzen den | Hileroko berritzea; egoera aktiboa, past_due edo iraungia |
| Entitlement | Aplikazioak egiaztatzen duen baimena | pro |
Hainbat produktuk entitlement bera eman dezakete. Horrela, webean ordaindu duenak eta iOSen ordaindu duenak funtzio bera desblokeatuta ikusiko dute.
Nola egiaztatu sarbidea Cifragoren APIarekin
| Endpoint-a | Zer egiten duen | Gakoa |
|---|---|---|
GET /api/v1/subscribers/{appUserId} | Entitlement aktiboak (activeEntitlementKeys), horien kopuruak, harpidetzak eta dendetako erosketak itzultzen ditu. Erabiltzailea existitzen ez bada, sortu egiten du | Publikoa edo sekretua |
POST /api/v1/receipts | App Store edo Google Play-ko ordainagiri bat erregistratzen du, sarbidea plataforma guztietan bera izan dadin | Publikoa edo sekretua |
POST /api/v1/subscribers/{appUserId}/grants | Sustapen-entitlement bat ematen du, hautazko iraungitze-datarekin | Sekretua soilik |
GET /api/v1/catalog eta GET /api/v1/offerings | Aplikazioaren produktuak, prezioak eta eskaintzak | — |
iOSen eta Androiden, aplikazioko erosketak App Store-tik edo Google Play-tik pasatzen dira derrigorrez. Cifragok ordainagiria erregistratzen du eta baimen bera mantentzen du leku guztietan. Baimena zerbitzarian bizi da, ez mugikorrean. Gako publikoak harpidetza irakurri eta erosketak erregistratu besterik ezin du egin; gainerako edozein endpoint-etan 401 kodea jasoko du.
Nola modelatzen den barrutik
entitlements: aplikazio bakoitzaren baimenak (adibidez,pro).price_entitlements: zein prezioak ematen duen zein baimen.store_product_entitlements: App Store edo Google Play-ko zein produktuk ematen duen zein baimen.- Kontsumigarriak (kredituak, paketeak) erregistratu egiten dira, baina ez dute entitlement-ik ematen.
Ohiko galderak
Zer da entitlement bat?
Erabiltzaile batek zure aplikazioko funtzio edo eduki bat erabiltzeko duen baimena da, adibidez «pro». Zure kodeak ez du galdetzen «produktu hau ordaindu al du?», baizik eta «baimen hau aktibo al du?». Horrek kodea errazten du eta hainbat plataformatan saltzeko aukera ematen du.
Zertan bereizten da harpidetza batetik?
Harpidetza ordainketa-akordioa da: prezioa, maiztasuna eta egoera. Entitlement-a, berriz, emaitza da: harpidetza aktibo dagoen bitartean edo grazia-aldian dagoen bitartean, erabiltzaileak baimena du. Harpidetza edo erosketa desberdin ugarik baimen bera eman dezakete.
Nola daki nire aplikazioak erabiltzaileak sarbidea duen?
GET /api/v1/subscribers/{appUserId} kontsultatuz eta baimena activeEntitlementKeys eremuan dagoen begiratuz. Erantzunak harpidetzak eta dendetako erosketak ere biltzen ditu, xehetasunak erabiltzaileari erakutsi nahi badizkiozu.
App Store eta Google Play bidezko erosketetarako balio du?
Bai. Aplikazioak ordainagiria POST /api/v1/receipts helbidera bidaltzen du, eta Cifragok webeko erosketa batek emango lukeen entitlement bera ematen du. Horrela, iPhonean ordaintzen duen erabiltzaileak Androidetik edo nabigatzailetik ere sarbidea izango du.
Harpidetzak muntatzen ari zara?
Begiratu tarifak eta probatu panela adibide-datuekin ezer integratu aurretik.