- Getting Started
- Canvas Tutorial
- Social Tutorials
- Examples
- Yahoo! Markup Language (YML)
- FAQ
- What parameters does YAP send to developers?
- How is authentication and authorization handled?
- What are the APIs that Apps can call on behalf of users?
- How do I get users’ location information?
- How do I get a user’s device information?
- How do I uniquely identify each Yahoo! user?
- How do I change game dimensions dynamically if a game is embedded in an iframe?
- How do I integrate with Yahoo! OAuth?
- How do I find out on which Yahoo! Property my App is running?
- Can I install Apps on Yahoo! Messenger for Mac?
- How many games sites will show my game and what is the URL format?
- Appendix A: Parameters
- Appendix B: YML Reference
Personalization and Localization¶
Use GeoPlanet to convert user-submitted locations into usable data such as latitude/longitude coordinates and city name. GeoPlanet is also available through YQL.
Reference yap_jurisdiction (an ISO 3166 country code passed as a post parameter to YAP apps) and Accept-Language (an RFC 2616 section 14.4 language priority list passed as a header to YAP apps).
Authentication¶
Yahoo! provides built-in authentication and authorization support. If an App requires a user’s personal data, Yahoo! shows a permission screen the first time the user starts using the App. Once a user gives permission, the developer can use OAuth to access the user’s personal data. Yahoo! sends access token information each time the App is loaded.
Terms of Use and Privacy Information¶
Developers can provide TOU (Terms of Use) and Privacy URLs. When provided, they will show automatically in a drop down on the permission screen. For example:
Respecting Your Users¶
User trust is essential for an app to be successful. Be respectful to your users. Design an experience that engages novices as they gain confidence with your app.
Don’t display sensitive or private information to others. (Example: “Mark just bought 4 shares of AAPL stock at $93.14/share.)