Important Ecosystem Guidelines
These guidelines must be followed by all clients in order for us to work towards a streamlined and efficient login experience to all users. These guidelines will also help us reach a higher share of logged in users throughout the ecosystem of products and services that has implemented Schibsted account. Everybody wins!
Web applications
What:
Always implement the JavaScript SDK
Why:
- Manages user login state seamlessly
- Answers if user need to accept your TOS or not
- Helps clients automatically retrieve tokens for API access for logged in users
- Tells client when a user is logged out centrally and/or if the logged in user has changed in Schibsted account
What:
Use the JavaScript SDK provided by Schibsted account, do not develop your own
Why:
- The SDK will be actively maintained by Schibsted account together with the community
- You may contribute to it on Github
What:
Check that your implementation follows the login flow
Why:
- This flow documents every state a user visiting your site might have
- It will improve the stability of your implementation and the user experience of your users
What:
Make sure that when user logs out, you trigger a logout from Schibsted account
Why:
- Respect the user’s choice when they choose to log out
- Consistency in the expected behaviour of a logout button/link
- To avoid confusing people and to protect personal security, we enforce this logout behavior
Mobile applications
What:
Use the official Schibsted account SDKs, do not develop your own:
Why:
Native apps that don’t use our SDKs will:
- not be offered technical support
- not have new introduced features, like device fingerprinting
Branding of Schibsted account
What:
Comply with the Schibsted account brand guidelines.
Note: The current brand guidelines are temporary and will be updated once the rebranding project is completed.
Why:
We need to offer a consistent and recognisable login experience across all products and services in the ecosystem
Guides
To-the-point technical guides that get you started with the Schibsted account API.
Getting started with the API
Connect your application to the Schibsted account API and make your first call, verify that your client ID and secrets are correctly configured.
Single Sign-On
Implementing Single Sign-On, how users log into your application via Schibsted account, and how you can access the Schibsted account API on their behalf.
Mobile development
Guide for native mobile development using the Schibsted account API.
Payment provider
Using Schibsted account as a payment provider, your users can purchase products via Schibsted account, and you can track their purchases in your application to give access to products and pages.
Working examples
So you prefer to dive straight into the code? Here are some example repos that work out of the box.
Getting started
Using Schibsted account as a payment provider
- Java: Paylinks
Articles
In-depth articles on various cross-cutting concerns.
Analytics and Insight
Self service and support
API and Integration
Payment
FAQs and HOWTOs
Official API clients and SDKs
Schibsted account provides officially supported API clients (SDKs) for several languages. All our libraries are hosted on GitHub, feel free to report any issues, send pull requests, or just have a look at the source.
Server-side client libraries
These libraries can be used to integrate with Schibsted account server-side. Directions for installation and basic use can be found in our getting started guide.
Client-side SDKs
These libraries solve different use cases than the server-side ones, and are generally more feature rich. They are designed to build client-side apps.
API reference
Looking for API details? Here you will find extensive reference documentation of all API endpoints.
Identity Management
User API
Authentication API
Identifier Status API
User agreements API
Login API
User devices
User connections API
Payment Services
Voucher API
GET
/voucher/{voucherCode}POST
/vouchers/generate/{voucherGroupId}POST
/vouchers/handout/{voucherGroupId}POST
/voucher_handoutGET
/vouchers/groupsGET
/vouchers/group/{voucherGroupId}POST
/vouchers/group/{voucherGroupId}POST
/vouchers/group
Campaign API
InjectToken API
Subscription API
POST
/user/{userId}/subscriptionPOST
/user/{userId}/subscription/{subscriptionId}/stopGET
/user/{userId}/subscription/{subscriptionId}POST
/user/{userId}/subscription/{subscriptionId}DELETE
/user/{userId}/subscription/{subscriptionId}GET
/user/{userId}/subscriptionsGET
/subscriptions
Product API
P2pLink API
PayLink API
POST
/paylinkPOST
/paylink/{paylinkId}/usePOST
/paylink/{paylinkId}/unlockPOST
/paylink/{paylinkId}/lockGET
/paylink/{paylinkId}DELETE
/paylink/{paylinkId}
Digital Contents API
GET
/user/{userId}/product/{productId}POST
/user/{userId}/product/{productId}DELETE
/user/{userId}/product/{productId}GET
/user/{userId}/productsGET
/digitalcontents
Bundle API
Other
Self Service API
GET
/client/{client_id}/teasersPOST
/client/{client_id}/teasersGET
/client/{client_id}/teasers/{teaser_id}POST
/client/{client_id}/teasers/{teaser_id}DELETE
/client/{client_id}/teasers/{teaser_id}GET
/merchant/{merchant_id}/trackergroupsPOST
/merchant/{merchant_id}/trackergroupsGET
/merchant/{merchant_id}/adminsPOST
/merchant/{merchant_id}/adminsGET
/merchant/{merchant_id}/admin/{admin_id}POST
/merchant/{merchant_id}/admin/{admin_id}DELETE
/merchant/{merchant_id}/admin/{admin_id}GET
/merchant/{merchant_id}/trackergroups/{id}POST
/merchant/{merchant_id}/trackergroups/{id}
Platform API
GET
/endpointsGET
/describe/{object}GET
/statusGET
/versionGET
/termsGET
/merchant/{merchant_id}GET
/clientsGET
/client/{client_id}GET
/client/{client_id}/aclGET
/settings
eID Verification API
Token API
Asset access check
GET
/user/{id}/asset/{assetId}POST
/user/{id}/asset/{assetId}DELETE
/user/{id}/asset/{assetId}GET
/user/{id}/assets/{assetIds}GET
/user/{id}/assetsGET
/asset/{id}/users/count
DataObjects API
GET
/user/{id}/dataobject/{key}POST
/user/{id}/dataobject/{key}DELETE
/user/{id}/dataobject/{key}GET
/user/{id}/dataobjectsGET
/dataobjects
KPI API
Token API
Didn't find what you were looking for? See the list of deprecated endpoints. New order and payment method APIs can be found here: Payment Platform Confluence