GSC REST Web Service Interface

 The General Systems REST API allows you to query the Winfunds database for accounts and trails. Since the API is based on REST principles, it's very easy to write and test applications. You can use your browser to access URIs, and you can use pretty much any HTTP client in any programming language to interact with the API.

New in v2.0 (Fall 2023)

All endpoints below have been replicated in v2.0 and utilize Oauth2 authentication

All v1.7 endpoints are still available using Oauth1 for backwards compatability

 

Base Url 

The base url for all endpoints in this documentation is https://traillinkws.winfundsonline.com/v1.7 All content is served only over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.

All methods require at least an API key. Methods acting on behalf of a user, or viewing user data, require either Oauth 1.0a (v1.7) or Oauth2 (v2.0) authentication.

Offline Status 

Whent the API is down for maintenance it will return a status 503 for all calls.  Consumers should handle this condition.

NOTES on URI Format:

All endpoint URIs should end in a slash:

GET /Trails/

URIs with an argument at the end should not end in a slash:

GET /Trails/6683560

Operations that require an API key only shoud have the api_key appended to the querystring.  The slash rules don't change:

GET /Trails/?api_key=52uy74r7donrh11omd56m2bylt1ld99165ceh816
GET /Trails/6683560?api_key=52uy74r7donrh11omd56m2bylt1ld99165ceh816

Operations that require OAuth should not have the api_key in the querystring.

REST Endpoints

These are for User Accounts and the data attached to them

Me

Accounts

Accounts/ConvioSSO

Accounts/Guidebooks

Accounts/Guidebooks/Trails

Accounts/Images

Accounts/Lists

Accounts/Lists/BulkUpdate

Accounts/Membership

Accounts/Receipts 

Accounts/Routes

Accounts/Events

Accounts/BucketList

These are for the data submitted by Users

Accounts/Trails

Accounts/Trails/Images

Accounts/Trails/Reviews

Accounts/HistoricPlaces

 

This is for resetting password

ResetPass

ResetPassword/Change

ResetPassword/Begin

 

These are for Trails and the data attached to them

Trails

Trails/Events

Trails/History

Trails/Images

Trails/Itinerary

Trails/Lines

Trails/Nearby

Trails/Reviews

Trails/Waypoints

Trails/Popular

 

These are the Events and data attached to them

Events

Events/Images

 

These are the Organizers and data attached to them

Organizers

Organizers/Images

 

These are the Historic Places and data attached to them

HistoricPlaces

HistoricPlaces/Nearby

HistoricPlaces/Location

HistoricPlaces/RelatedTrails

HistoricPlaces/Images

HistoricPlaces/FilterCards

 

 

These are for data which can be attached to Trails or Users.  These will generally be used in conjunction with their respective methods attached to Trails or Accounts.

Images

Reviews

 

These are lookups

Activities

Attractions

Categories

Cities

Cities/Nearby

Counties

Lists

States

Surfaces

Lookups/TrailImages

 

New 3.0 Endpoints

Trails

Trails/National

Trails/Lines

Accounts

Accounts/Images

Geolocation