Introduction

Version: 0.4 (Preview) · Changelog

The Parkdly API lets external disc golf applications connect to Parkdly. Users control the access of each application.

What You Can Do

With the Parkdly API, an external application can:

  • Authenticate users with OAuth 2.0 and PKCE.
  • Read course data, when the user gives permission.
  • Create courses for the user.
  • Receive updates through webhooks.

Getting Started

1. Register Your Application

Contact Parkdly to register your external application. You receive:

  • client_id - The identifier of your application.
  • client_secret - A secret key. Keep it private.
  • redirect_uri - The registered callback URL of your application.

📧 Email info@parkdly.com to request API access.

2. Implement OAuth Flow

Use the Authentication guide to implement the OAuth 2.0 flow with PKCE.

3. Make API Calls

After authentication, put the access token in the Authorization header of each request:

curl https://parkdly.com/api/v1/courses -H "Authorization: Bearer {token}"

Next Steps

Previous — TerminologyTerminology
NextAuthentication