2.1.1 • Published 5 years ago

geocaching-api v2.1.1

Weekly downloads
3
License
ISC
Repository
github
Last release
5 years ago

api_v1_0

ApiV10 - JavaScript client for api_v1_0 API version 1.0. This SDK is automatically generated by the OpenAPI Generator project:

  • API version: v1
  • Package version: v1
  • Build package: org.openapitools.codegen.languages.JavascriptClientCodegen For more information, please visit http://www.geocaching.com

Installation

For Node.js

npm

To publish the library as a npm, please follow the procedure in "Publishing npm packages".

Then install it via:

npm install api_v1_0 --save

Finally, you need to build the module:

npm run build
Local development

To use the library locally without publishing to a remote npm registry, first install the dependencies by changing into the directory containing package.json (and this README). Let's call this JAVASCRIPT_CLIENT_DIR. Then run:

npm install

Next, link it globally in npm with the following, also from JAVASCRIPT_CLIENT_DIR:

npm link

To use the link you just defined in your project, switch to the directory you want to use your api_v1_0 from, and run:

npm link /path/to/<JAVASCRIPT_CLIENT_DIR>

Finally, you need to build the module:

npm run build

git

If the library is hosted at a git repository, e.g.https://github.com/GIT_USER_ID/GIT_REPO_ID then install it via:

    npm install GIT_USER_ID/GIT_REPO_ID --save

For browser

The library also works in the browser environment via npm and browserify. After following the above steps with Node.js and installing browserify with npm install -g browserify, perform the following (assuming main.js is your entry file):

browserify main.js > bundle.js

Then include bundle.js in the HTML pages.

Webpack Configuration

Using Webpack you may encounter the following error: "Module not found: Error: Cannot resolve module", most certainly you should disable AMD loader. Add/merge the following section to your webpack config:

module: {
  rules: [
    {
      parser: {
        amd: false
      }
    }
  ]
}

Getting Started

Please follow the installation instruction and execute the following JS code:

var ApiV10 = require('api_v1_0');


var api = new ApiV10.FriendsApi()
var requestId = 56; // {Number} friend request identifier
var apiVersion = "'1.0'"; // {String} The requested API version
api.friendsAcceptFriendRequest(requestId, apiVersion).then(function() {
  console.log('API called successfully.');
}, function(error) {
  console.error(error);
});

Documentation for API Endpoints

All URIs are relative to https://api.groundspeak.com

ClassMethodHTTP requestDescription
ApiV10.FriendsApifriendsAcceptFriendRequestPOST /v{api-version}/friendrequests/{requestId}/acceptAccept a friend request
ApiV10.FriendsApifriendsCreateFriendRequestPOST /v{api-version}/friendrequestsCreate a friend request
ApiV10.FriendsApifriendsDeleteFriendRequestDELETE /v{api-version}/friendrequests/{requestId}Delete a friend request
ApiV10.FriendsApifriendsGetFriendRequestsGET /v{api-version}/friendrequestsGet a list of friend requests for the calling user
ApiV10.FriendsApifriendsGetFriendsGET /v{api-version}/friendsGet a list of friends for the calling user
ApiV10.FriendsApifriendsRemoveFriendDELETE /v{api-version}/friends/{userCode}Removes a friend
ApiV10.GeoToursApigeoToursGetGeoTourGET /v{api-version}/geotours/{referenceCode}Get a GeoTour
ApiV10.GeoToursApigeoToursGetGeoToursGET /v{api-version}/geotoursGet GeoTours
ApiV10.GeoToursApigeoToursGetGeocachesByGeoTourGET /v{api-version}/geotours/{referenceCode}/geocachesGet the geocaches on the GeoTour
ApiV10.GeocacheLogsApigeocacheLogsAddImagePOST /v{api-version}/geocachelogs/{referenceCode}/imagesAdd an image to a geocache log
ApiV10.GeocacheLogsApigeocacheLogsCreateGeocacheLogPOST /v{api-version}/geocachelogsAdd a log to a geocache
ApiV10.GeocacheLogsApigeocacheLogsDeleteGeocacheLogDELETE /v{api-version}/geocachelogs/{referenceCode}Delete a geocache log
ApiV10.GeocacheLogsApigeocacheLogsDeleteGeocacheLogImagesDELETE /v{api-version}/geocachelogs/{referenceCode}/images/{imageGuid}Deletes a geocache log image
ApiV10.GeocacheLogsApigeocacheLogsGetGeocacheLogGET /v{api-version}/geocachelogs/{referenceCode}Get a single geocache log
ApiV10.GeocacheLogsApigeocacheLogsGetImagesGET /v{api-version}/geocachelogs/{referenceCode}/imagesGet a the images attached to a geocache log
ApiV10.GeocacheLogsApigeocacheLogsUpdateGeocacheLogPUT /v{api-version}/geocachelogs/{referenceCode}Update a geocache log
ApiV10.GeocacheNotesApigeocacheNotesDeleteNoteDELETE /v{api-version}/geocaches/{referenceCode}/notesDelete a geocache note for the calling user
ApiV10.GeocacheNotesApigeocacheNotesUpsertNotePUT /v{api-version}/geocaches/{referenceCode}/notesUpsert a geocache note for the calling user
ApiV10.GeocachesApigeocachesGetFavoritedByGET /v{api-version}/geocaches/{referenceCode}/favoritedbyGet a list of Users that have favorited a geocache
ApiV10.GeocachesApigeocachesGetGeocacheGET /v{api-version}/geocaches/{referenceCode}Get a single Geocache
ApiV10.GeocachesApigeocachesGetGeocachesGET /v{api-version}/geocachesGet a list of geocaches
ApiV10.GeocachesApigeocachesGetImagesGET /v{api-version}/geocaches/{referenceCode}/imagesGet a list of images for a geocache
ApiV10.GeocachesApigeocachesGetLogsGET /v{api-version}/geocaches/{referenceCode}/geocachelogsGet a list of geocache logs for the specified geocache
ApiV10.GeocachesApigeocachesGetTrackablesGET /v{api-version}/geocaches/{referenceCode}/trackablesGet a list of trackables in a geocache
ApiV10.GeocachesApigeocachesSearchGET /v{api-version}/geocaches/searchSearch for Geocaches
ApiV10.HQPromotionsApihQPromotionsGetGET /v{api-version}/HQPromotions/metadataReturns a list of metadata for currently visible and upcoming Geocaching HQ promotions
ApiV10.ListsApilistsAddGeocachePOST /v{api-version}/lists/{referenceCode}/geocachesAdd a geocache to a list
ApiV10.ListsApilistsAddGeocachesPOST /v{api-version}/lists/{referenceCode}/bulkgeocachesAdd multiple geocaches to a list
ApiV10.ListsApilistsCreateListPOST /v{api-version}/listsCreate a list
ApiV10.ListsApilistsDeleteGeocacheDELETE /v{api-version}/lists/{referenceCode}/geocaches/{geocacheReferenceCode}Remove a geocache from a list
ApiV10.ListsApilistsDeleteListDELETE /v{api-version}/lists/{referenceCode}Remove a list
ApiV10.ListsApilistsGetGeocachesGET /v{api-version}/lists/{referenceCode}/geocachesGet a list of geocaches for a specified list
ApiV10.ListsApilistsGetListGET /v{api-version}/lists/{referenceCode}Get a list
ApiV10.ListsApilistsGetZippedPocketQueryGET /v{api-version}/lists/{referenceCode}/geocaches/zippedGets a zipped file for a pocket query
ApiV10.ListsApilistsUpdateListPUT /v{api-version}/lists/{referenceCode}Edit a list
ApiV10.LogDraftsApilogDraftsAddImagePOST /v{api-version}/logdrafts/{referenceCode}/imagesAdd image to log draft
ApiV10.LogDraftsApilogDraftsCreateDraftPOST /v{api-version}/logdraftsCreate a log draft
ApiV10.LogDraftsApilogDraftsDeleteDraftDELETE /v{api-version}/logdrafts/{referenceCode}Delete a log draft
ApiV10.LogDraftsApilogDraftsGetDraftGET /v{api-version}/logdrafts/{referenceCode}Get a single log draft for the calling user
ApiV10.LogDraftsApilogDraftsGetUserDraftsGET /v{api-version}/logdraftsGet a list of log drafts for the calling user
ApiV10.LogDraftsApilogDraftsPromoteToGeocacheLogPOST /v{api-version}/logdrafts/{referenceCode}/promotePromote Log Draft to Geocache Log
ApiV10.LogDraftsApilogDraftsUpdateDraftPUT /v{api-version}/logdrafts/{referenceCode}Update a log draft
ApiV10.ReferenceDataApireferenceDataGetAttributesGET /v{api-version}/attributesReturns the available attributes
ApiV10.ReferenceDataApireferenceDataGetCountriesGET /v{api-version}/countriesReturns current list of country ids and names
ApiV10.ReferenceDataApireferenceDataGetGeocacheLogTypesGET /v{api-version}/geocachelogtypesReturns the geocache log types
ApiV10.ReferenceDataApireferenceDataGetGeocacheTypesGET /v{api-version}/geocachetypesReturns the available geocache types
ApiV10.ReferenceDataApireferenceDataGetMembershipLevelsGET /v{api-version}/membershiplevelsReturns the membership levels
ApiV10.ReferenceDataApireferenceDataGetStatesGET /v{api-version}/statesReturns the state (aka region) names and ids
ApiV10.ReferenceDataApireferenceDataGetStatesByCountryGET /v{api-version}/countries/{countryId}/statesReturns the state (aka region) names and ids
ApiV10.ReferenceDataApireferenceDataGetTrackableLogTypesGET /v{api-version}/trackablelogtypesReturns the trackable log types
ApiV10.StatusApistatusPingAsyncGET /status/pingReturns Ok.
ApiV10.TrackableLogsApitrackableLogsAddImagePOST /v{api-version}/trackablelogs/{referenceCode}/imagesAdd an image to a trackable log
ApiV10.TrackableLogsApitrackableLogsCreateTrackableLogPOST /v{api-version}/trackablelogsAdd a log to a trackable
ApiV10.TrackableLogsApitrackableLogsDeleteTrackableLogDELETE /v{api-version}/trackablelogs/{referenceCode}Deletes a trackable log
ApiV10.TrackableLogsApitrackableLogsDeleteTrackableLogImagesDELETE /v{api-version}/trackablelogs/{referenceCode}/images/{imageGuid}Deletes a trackable log image
ApiV10.TrackableLogsApitrackableLogsGetImagesGET /v{api-version}/trackablelogs/{referenceCode}/imagesGet a the images attached to a trackable log
ApiV10.TrackableLogsApitrackableLogsGetTrackableLogGET /v{api-version}/trackablelogs/{referenceCode}Get a single trackable log
ApiV10.TrackableLogsApitrackableLogsUpdateTrackableLogPUT /v{api-version}/trackablelogs/{referenceCode}Update a trackable log
ApiV10.TrackablesApitrackablesGetGeocoinTypesGET /v{api-version}/trackables/geocointypesGet paged geocoin types
ApiV10.TrackablesApitrackablesGetImagesGET /v{api-version}/trackables/{referenceCode}/ImagesGet the images attached to a trackable
ApiV10.TrackablesApitrackablesGetTrackableGET /v{api-version}/trackables/{referenceCode}Get a single trackable
ApiV10.TrackablesApitrackablesGetTrackableLogsGET /v{api-version}/trackables/{referenceCode}/trackablelogsGet a list of trackable logs for the specified trackable
ApiV10.TrackablesApitrackablesGetUserTrackablesGET /v{api-version}/trackablesGets a list of trackables
ApiV10.UserWaypointsApiuserWaypointsCreateUserWaypointPOST /v{api-version}/userwaypointsCreate a user waypoint
ApiV10.UserWaypointsApiuserWaypointsDeleteCorrectedCoordinatesDELETE /v{api-version}/geocaches/{referenceCode}/correctedcoordinatesDelete a corrected coordinate for the calling user
ApiV10.UserWaypointsApiuserWaypointsDeleteUserWaypointDELETE /v{api-version}/userwaypoints/{referenceCode}Delete a user waypoint
ApiV10.UserWaypointsApiuserWaypointsGetGeocacheUserWaypointsGET /v{api-version}/geocaches/{referenceCode}/userwaypointsGets the user waypoints for a geocache
ApiV10.UserWaypointsApiuserWaypointsGetUserWaypointsGET /v{api-version}/userwaypointsGet a list of user waypoints for the calling user
ApiV10.UserWaypointsApiuserWaypointsUpdateUserWaypointPUT /v{api-version}/userwaypoints/{referenceCode}Update a user waypoint
ApiV10.UserWaypointsApiuserWaypointsUpsertCorrectedCoordinatesPUT /v{api-version}/geocaches/{referenceCode}/correctedcoordinatesUpsert a corrected coordinate for the calling user
ApiV10.UsersApiusersGetGeocacheLogsGET /v{api-version}/users/{referenceCode}/geocachelogsGet a list of a user's geocache logs
ApiV10.UsersApiusersGetImagesGET /v{api-version}/users/{referenceCode}/imagesGet the images attached to a user profile
ApiV10.UsersApiusersGetListsGET /v{api-version}/users/{referenceCode}/listsGet a list of user's geocache lists
ApiV10.UsersApiusersGetSouvenirsGET /v{api-version}/users/{referenceCode}/souvenirsGet an account's souvenirs
ApiV10.UsersApiusersGetUserGET /v{api-version}/users/{referenceCode}Get a user
ApiV10.UsersApiusersGetUsersGET /v{api-version}/usersGet a list of users
ApiV10.UtilitiesApiutilitiesGetReferenceCodeGET /v{api-version}/utilities/referencecodeReturns the reference code from an id

Documentation for Models

Documentation for Authorization

AccessToken

  • Type: API key
  • API key parameter name: AccessToken
  • Location: HTTP header
2.1.1

5 years ago

2.1.1-develop

5 years ago

2.1.0

5 years ago

2.1.0-beta2

5 years ago

2.1.0-beta1

5 years ago

1.0.7

8 years ago

1.0.6

9 years ago

1.0.5

9 years ago

1.0.4

9 years ago

1.0.3

9 years ago

1.0.2

9 years ago