Difference between revisions of "Nookipedia:Development"

From Nookipedia, the Animal Crossing wiki
(Adding Nookipedia template)
(→‎Nookipedia API: Fixing link)
Tags: mobile edit mobile web edit
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Nookipedia provides the ability for developers to access its content for development projects through the [https://www.mediawiki.org/wiki/API:Main_page MediaWiki API]. MediaWiki is the wiki software that Nookipedia runs on.
+
Nookipedia provides the ability for developers to access its content for development projects through two APIs. We encourage developers to use Nookipedia's API to develop bots, tools, applications, and more! This page serves as an introduction to the APIs, as well as a directory of existing developers' projects.
  
 
== Development ==
 
== Development ==
Nookipedia's content can be accessed through the [https://www.mediawiki.org/wiki/API:Main_page MediaWiki API]. Examples of possibilities include:
+
Nookipedia has two APIs available for use: our own custom API, and the standard MediaWiki API.
* Extracting information from infoboxes
 
* Getting lists of characters by game
 
* Editor statistics
 
* ...and much more!
 
  
Developing and using the MediaWiki API takes some know-how. If you're new to using the MediaWiki API, we recommend looking over the following to get started:
+
=== Nookipedia API ===
 +
 
 +
Nookipedia has its own '''[https://nookipedia.com/api/ custom API]''', which surfaces certain content from Nookipedia's pages. There are currently two endpoints, with more to come:
 +
* <code>today</code>, which returns holiday and villager birthday data.
 +
* <code>villager</code>, which returns detailed information about a villager.
 +
 
 +
Users can request access to the API by following the instructions on the page. If you have questions regarding using Nookipedia's API, feel free to post them on [[Nookipedia_talk:Development|the talk page]]. Users who are actively developing projects using the API are also encouraged to join us on [https://discord.gg/5Sfg3CT Discord]. You'll be assigned the API developer role and will gain access to our support channel where you can ask questions directly. Contact one of Nookipedia's [[Nookipedia:Directors|directors]] for more information.
 +
 
 +
=== MediaWiki API ===
 +
Nookipedia also has the [https://www.mediawiki.org/wiki/API:Main_page MediaWiki API], which comes standard on all MediaWiki instances. It can be used to grab statistics about the wiki; edit pages and upload files; grab page content to scrape; and more. If you're new to using the MediaWiki API, we recommend looking over the following to get started:
 
* [https://www.mediawiki.org/wiki/API:Main_page MediaWiki API Introduction and examples]
 
* [https://www.mediawiki.org/wiki/API:Main_page MediaWiki API Introduction and examples]
 
* [https://www.mediawiki.org/wiki/API:FAQ MediaWiki API FAQ]
 
* [https://www.mediawiki.org/wiki/API:FAQ MediaWiki API FAQ]
 
* [https://www.mediawiki.org/wiki/API:Query MediaWiki API Queries]
 
* [https://www.mediawiki.org/wiki/API:Query MediaWiki API Queries]
 
If you have questions regarding using Nookipedia's API, you may ask them on [[/talk|the talk page]].
 
  
 
=== Licensing ===
 
=== Licensing ===
Line 22: Line 25:
 
== Projects ==
 
== Projects ==
 
The following is a list of community-made tools that utilize Nookipedia's API. If you have created your own project that isn't listed below, feel free to add it!
 
The following is a list of community-made tools that utilize Nookipedia's API. If you have created your own project that isn't listed below, feel free to add it!
 +
 +
* Nookipedia's official organizational projects are hosted at [https://github.com/Nookipedia github.com/Nookipedia]:
 +
** [https://github.com/Nookipedia/Ribbot Ribbot]: "Cogs" for Nookipedia's official Discord bot, running off of [https://github.com/Twentysix26/Red-DiscordBot Red].
 +
 +
Other projects built by the community are as follows:
 
* [https://github.com/zackshank/nookscraper Nookscraper on GitHub]: A tool written in Go to scrape data from villager pages.
 
* [https://github.com/zackshank/nookscraper Nookscraper on GitHub]: A tool written in Go to scrape data from villager pages.
 
* [https://www.reddit.com/user/PellyBot PellyBot on Reddit]: A reddit bot that posts daily updates to the [https://www.reddit.com/r/AnimalCrossing/ ''Animal Crossing'' subreddit]. The updates include events and birthdays for the week.
 
* [https://www.reddit.com/user/PellyBot PellyBot on Reddit]: A reddit bot that posts daily updates to the [https://www.reddit.com/r/AnimalCrossing/ ''Animal Crossing'' subreddit]. The updates include events and birthdays for the week.
 +
* [https://gitlab.com/melancholera/sonchou/ Sonchou]: Some packages and scripts written in Go that could be useful to future users and developers of Nookipedia. More information can be found in [https://godoc.org/gitlab.com/melancholera/sonchou the godoc].
 +
* [https://github.com/Nookbot/Nookbot Nookbot]: A bot for the Animal Crossing: New Horizons Discord server. Includes a villager information lookup.
  
  

Revision as of 19:39, April 8, 2020

Nookipedia provides the ability for developers to access its content for development projects through two APIs. We encourage developers to use Nookipedia's API to develop bots, tools, applications, and more! This page serves as an introduction to the APIs, as well as a directory of existing developers' projects.

Development

Nookipedia has two APIs available for use: our own custom API, and the standard MediaWiki API.

Nookipedia API

Nookipedia has its own custom API, which surfaces certain content from Nookipedia's pages. There are currently two endpoints, with more to come:

  • today, which returns holiday and villager birthday data.
  • villager, which returns detailed information about a villager.

Users can request access to the API by following the instructions on the page. If you have questions regarding using Nookipedia's API, feel free to post them on the talk page. Users who are actively developing projects using the API are also encouraged to join us on Discord. You'll be assigned the API developer role and will gain access to our support channel where you can ask questions directly. Contact one of Nookipedia's directors for more information.

MediaWiki API

Nookipedia also has the MediaWiki API, which comes standard on all MediaWiki instances. It can be used to grab statistics about the wiki; edit pages and upload files; grab page content to scrape; and more. If you're new to using the MediaWiki API, we recommend looking over the following to get started:

Licensing

Nookipedia's text content is released under a CC BY-SA 3.0 license. When using Nookipedia's text in your application, we request that you follow the terms of the license by citing Nookipedia as the source of the information, and linking back to the article's history when possible.

In the spirit of open source and knowledge, we also request that you open source your application (on a site such as GitHub) when possible.

Projects

The following is a list of community-made tools that utilize Nookipedia's API. If you have created your own project that isn't listed below, feel free to add it!

  • Nookipedia's official organizational projects are hosted at github.com/Nookipedia:
    • Ribbot: "Cogs" for Nookipedia's official Discord bot, running off of Red.

Other projects built by the community are as follows:

  • Nookscraper on GitHub: A tool written in Go to scrape data from villager pages.
  • PellyBot on Reddit: A reddit bot that posts daily updates to the Animal Crossing subreddit. The updates include events and birthdays for the week.
  • Sonchou: Some packages and scripts written in Go that could be useful to future users and developers of Nookipedia. More information can be found in the godoc.
  • Nookbot: A bot for the Animal Crossing: New Horizons Discord server. Includes a villager information lookup.