Documentation
gw2.me uses OAuth 2.0 to manage the access between users and applications.
This documentation is aimed at developers who want to integrate gw2.me into their applications, so their users can use gw2.me to authorize the app to access the Guild Wars 2 API on their behalf.
Use gw2.me in your application
- Get an access token by navigating the user to the authorization page.
- Access the Guild Wars 2 API by generating subtokens or use other gw2.me APIs.
Most of these steps can be handled by using existing OAuth2 libraries or the gw2.me specific client libraries.
OAuth2 URLs
| Endpoint | URL |
|---|---|
| Authorization Server Metadata | https://gw2.me/.well-known/oauth-authorization-server |
| Base authorization URL | https://gw2.me/oauth2/authorize |
| Token URL | https://gw2.me/api/token |
Why gw2.me
gw2.me provides secure way for users to manage access between multiple Guild Wars 2 accounts and applications.
- User don't have to handle API keys for every application, instead they just have to setup gw2.me once.
- gw2.me generates secure subtokens with the specific scopes requested by the application.
- gw2.me also handles all errors around invalid API keys, so applications always receive valid API keys.
- Instead of instructing the user how to generate API keys and which permissions are required, applications can instead just include a Login with gw2.me button.
- Users can review and revoke access to any application at any point, which is often not possible with API keys because users tend to reuse the same API key for multiple applications.
Support
If you have any questions or need help integrating gw2.me into your application, you can use the #gw2treasures channel on GW2 Development Community Discord server.
If you find any bugs on gw2.me you can report them in the GitHub issue tracker.
Contribute
You can contribute to the development of gw2.me in the GW2Treasures/gw2.me repository on github.