THNapi:Items DB API Changes

Note: This document is a Work In progress. It is not final and will change.

This pages is about the upcoming API changes in the Items DB. The new endpoointx will be available in 3.1.xx (Version to be added). The old API endpoints will be removed in Items DB V3.2.0

The current issues

• The current API design is based on a design from Items DB V1 updated for Items DB2. The original API was created in 2007 and really doesn't follow modern day standards.
• Sharing the endpoints API with the public HTML view eg https://db.techhaven.org/en/weapons/heavy and https://db.techhaven.org/en/weapons/heavy.json can be confusing.
• The HTML endpoints are language aware https://db.techhaven.org/en/weapons/heavy and https://db.techhaven.org/de/weapons/heavy Using the endpoint https://db.techhaven.org/weapons/heavy.json always redirects to https://db.techhaven.org/en/weapons/heavy.json
• Endpoints really shouldn't redirect.
• Then Authentication layer is messy due to the shared endpoints with API keys and THN User logins.
• The naming of the header params is confusing.

The solution

• Some endpoints on https://db.techhaven.org/api/* Will move to https://db.techhaven.org/nc-db/api/v3.0/*
• New endpoint for getting groups will be added to replace the current method
• New endpoint for getting items will be added to replace the current method
• Correct the API Header Params order.

Group Access List

• This has moved from https://db.techhaven.org/api/access-list.json to https://db.techhaven.org/nc-db/api/v3.0/group-access-list.json