Introduction
Version: 0.1 (Preview)
Welcome to the Parkdly API documentation. The Parkdly API enables external disc golf applications to integrate with Parkdly's course management platform through a secure, user-controlled authentication system.
What You Can Do
The Parkdly API allows external applications to:
- Authenticate users via OAuth 2.0 with PKCE support
- Access course data with explicit user permission
- Maintain secure integrations with user-controlled access
- Receive real-time updates via webhooks
Getting Started
1. Register Your Application
Contact Parkdly to register your external application. You'll receive:
- client_id - Your application identifier
- client_secret - Secret key (keep this secure!)
- redirect_uri - Your registered callback URL
đź“§ Email info@parkdly.com to request API access.
2. Implement OAuth Flow
Follow our Authentication guide to implement the OAuth 2.0 flow with PKCE support.
3. Make API Calls
Once authenticated, include the access token in your requests:
curl https://parkdly.com/api/v1/courses -H "Authorization: Bearer {token}"
Next Steps
- Authentication - Deep dive into OAuth 2.0 implementation
- API Endpoints - Complete endpoint reference
- Webhooks - Set up real-time notifications