Latest Neocron News and Information

  • New test server patch #545 has been released to Vedeena

Difference between revisions of "THNapi:Items DB - JSON Examples"

From Neocron Wiki
Jump to: navigation, search
(Deprecation warning about using the items slug)
(Correct list)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== List of groups of datasets you have access to ==
 
== List of groups of datasets you have access to ==
  
−
<pre>
+
<syntaxhighlight lang="Bash">
−
curl -i -H "X-THN-API-User: <Your API user Key>" -H "X-THN-API-Key: <Your API key secret>" -H "Accept: application/json" -H "Content-Type: application/json" -L https://db.techhaven.org/api/access-list.json
+
curl -i -H "X-THN-API-Key: <Your API key>" -H "X-THN-API-Secret: <Your API secret>" -H "Accept: application/json" -H "Content-Type: application/json" https://db.techhaven.org/nc-db/api/v3.0/group-access-list.json
−
</pre>
+
</syntaxhighlight>
  
 
=== Response ===
 
=== Response ===
−
<pre>
+
<syntaxhighlight lang="json">
 
{
 
{
 
     "deny": [], // For THN use only
 
     "deny": [], // For THN use only
Line 28: Line 28:
 
     ]
 
     ]
 
}
 
}
−
</pre>
+
</syntaxhighlight>
  
 
== API Response for a group ==
 
== API Response for a group ==
−
<pre>
+
<syntaxhighlight lang="Bash">
−
curl -i -H "X-THN-API-User: <Your API user Key>" -H "X-THN-API-Key: <Your API key secret>" -H "Accept: application/json" -H "Content-Type: application/json" -L https://db.techhaven.org/weapons/melee.json
+
curl -i -H "X-THN-API-Key: <Your API key>" -H "X-THN-API-Secret: <Your API secret>" -H "Accept: application/json" -H "Content-Type: application/json" https://db.techhaven.org/nc-db/api/v3.0/get-group.json?path=weapons/melee
−
</pre>
+
</syntaxhighlight>
  
 
=== Response ===
 
=== Response ===
−
<pre>
+
<syntaxhighlight lang="json">
 
{
 
{
 
     "groups": {
 
     "groups": {
Line 135: Line 135:
 
         },
 
         },
 
       ... // Rest of JSON response cut for clarity
 
       ... // Rest of JSON response cut for clarity
−
</pre>
+
</syntaxhighlight>
  
 
== API Response for an Item ==
 
== API Response for an Item ==
−
<pre>
+
<syntaxhighlight lang="Bash">
−
curl -i -H "X-THN-API-User: <Your API user Key>" -H "X-THN-API-Key: <Your API key secret>" -H "Accept: application/json" -H "Content-Type: application/json" -L https://db.techhaven.org/item/1562.json
+
curl -i -H "X-THN-API-Key: <Your API key>" -H "X-THN-API-Secret: <Your API secret>" -H "Accept: application/json" -H "Content-Type: application/json" https://db.techhaven.org/nc-db/api/v3.0/get.json?item=1562
−
</pre>
+
</syntaxhighlight>
−
..or you can use the item slug.
 
−
 
 
−
'''Warning:''' Using a Item slug is deprecated and will be removed in V3.2.0 of the Items DB.
 
−
 
 
−
<pre>
 
−
curl -i -H "X-THN-API-User: <Your API user Key>" -H "X-THN-API-Key: <Your API key secret>" -H "Accept: application/json" -H "Content-Type: application/json" -L https://db.techhaven.org/item/mendicant-rifle.json
 
−
</pre>
 
  
 
=== Response ===
 
=== Response ===
−
<pre>
+
<syntaxhighlight lang="json">
 
{
 
{
 
     "groups": {
 
     "groups": {
Line 263: Line 256:
 
     }
 
     }
 
}
 
}
−
</pre>
+
</syntaxhighlight>
 +
 
 +
== Items DB API Breaking changes 3.2 ==
  
−
== Note on redirects ==
+
Version 3.2 introduces a new set of API endpoints for getting data from the Items DB, and drops getting data via the User UI by adding .json to the endpoint. This means you will have to update your application to use the new endpoints.
  
−
You will note the '''-L''' option in the Curl examples. This is due to the Items DB redirecting to the required language (English and German currently supported) so https://db.techhaven.org/weapons/melee.json will redirect to  https://db.techhaven.org/en/weapons/melee.json This redirect behaviour will be changed in V3.2.0 of the Items DB.
+
* API endpoints will no longer based on the language.
 +
* The authentication headers have changed. The old headers will work until April 1st 2021
 +
** X-THN-API-User is now X-THN-API-Key
 +
** X-THN-API-Key is now X-THN-API-Secret
 +
** See [[THNapi:Authentication]] for further deails.
 +
* Access list 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
 +
* Groups lists has moved and the path element is now a parameter. So https://db.techhaven.org/weapons/melee.json is now https://db.techhaven.org/nc-db/api/v3.0/get-group.json?path=weapons/melee
 +
* Using an item slug to get an item is dropped. You must use an item ID.
 +
* Fetching an item has moved and the item element is now a parameter - https://db.techhaven.org/item/1562.json is now https://db.techhaven.org/nc-db/api/v3.0/get.json?item=1562

Latest revision as of 17:21, 1 February 2021

List of groups of datasets you have access to

curl -i -H "X-THN-API-Key: <Your API key>" -H "X-THN-API-Secret: <Your API secret>" -H "Accept: application/json" -H "Content-Type: application/json" https://db.techhaven.org/nc-db/api/v3.0/group-access-list.json

Response

{
    "deny": [], // For THN use only
    "granted": [
        {
            "name": "Rifles",
            "path": "weapons/rifles",
            "granted": true
        },
        {
            "name": "Helmets",
            "path": "armor/helmets",
            "granted": true
        },
        {
            "name": "Brain implants",
            "path": "implants/brain",
            "granted": true
        },
        ... // Rest of output skipped for clarity.
    ]
}

API Response for a group

curl -i -H "X-THN-API-Key: <Your API key>" -H "X-THN-API-Secret: <Your API secret>" -H "Accept: application/json" -H "Content-Type: application/json" https://db.techhaven.org/nc-db/api/v3.0/get-group.json?path=weapons/melee

Response

{
    "groups": {
        "65": {
            "id": 65,
            "groupPath": "weapons/melee/lowtech",
            "name": "Lowtech Melee Weapon",
            "shortName": "Lowtech Melee Weapon",
            "description": "A weapon requiring the Melee Combat (M-C) Skill."
        },
        "76": {
            "id": 76,
            "groupPath": "weapons/melee/hightech",
            "name": "Hightech Melee Weapon",
            "shortName": "Hightech Melee Weapon",
            "description": "A weapon requiring the Melee Combat (M-C) and Hightech Combat (T-C) Skills."
        }
    },
    "items": [
        {
            "id": 1265,
            "visible": true,
            "pendingUpdates": false,
            "slug": "stiletto",
            "name": "Stiletto",
            "shortName": null,
            "level": 2,
            "patch": 176,
            "version": 2,
            "added": {
                "date": "2006-10-28 12:00:00.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "updated": {
                "date": "2007-04-09 12:34:56.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "detail": {
                "2": {
                    "parentVersion": 1,
                    "weight": "0.35",
                    "text": null,
                    "name": "Stiletto",
                    "shortName": null,
                    "level": 2,
                    "patch": 176,
                    "version": 2,
                    "added": {
                        "date": "2007-04-09 12:34:56.000000",
                        "timezone_type": 3,
                        "timezone": "UTC"
                    },
                    "updated": {
                        "date": "2007-04-09 12:34:56.000000",
                        "timezone_type": 3,
                        "timezone": "UTC"
                    },
                    "status": "Imported",
                    "image": {
                        "x": 64,
                        "y": 32,
                        "cdn_url": "https://cdn.techhaven.org/xxxxxxxxxxxxxxxxxxxxx.png", // Only visible to API users with access
                        "filename": "xxxxxxxxxxxxxxxxxxxxx.png" // Only visible to API users with access
                    },
                    "attribute": [ // Not all attributes will be available to API users
                        {
                            "name": "Strength",
                            "shortName": "STR",
                            "attributeGroup": "Main Skills",
                            "attributeType": "requirement",
                            "value": "1.00",
                            "formatValue": 1
                        },
                        {
                            "name": "This item is researchable",
                            "shortName": "Researchable",
                            "attributeGroup": "Item information",
                            "attributeType": "tag",
                            "value": "1.00",
                            "formatValue": "Enabled"
                        },
                        {
                            "name": "This item can be purchased from a shop vendor",
                            "shortName": "Purchasable",
                            "attributeGroup": "Item procurement",
                            "attributeType": "tag",
                            "value": "1.00",
                            "formatValue": "Enabled"
                        }
                    ],
                    "groupReference": 65
                }
            },
            "url": "https://db.techhaven.org/item/stiletto",
            "url_json": "https://db.techhaven.org/item/1265.json"
        },
       ... // Rest of JSON response cut for clarity

API Response for an Item

curl -i -H "X-THN-API-Key: <Your API key>" -H "X-THN-API-Secret: <Your API secret>" -H "Accept: application/json" -H "Content-Type: application/json" https://db.techhaven.org/nc-db/api/v3.0/get.json?item=1562

Response

{
    "groups": {
        "63": {
            "id": 63,
            "groupPath": "weapons/rifles/lowtech",
            "name": "Lowtech Rifle",
            "shortName": "Lowtech Rifle",
            "description": "A weapon requiring the Rifle Combat (R-C) Skill."
        }
    },
    "item": {
        "parentVersion": null,
        "weight": "3.65",
        "text": null,
        "name": "Mendicant Rifle",
        "shortName": null,
        "level": 6,
        "patch": 176,
        "version": 1,
        "added": {
            "date": "2006-01-31 11:56:53.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "updated": {
            "date": "2006-01-31 11:56:53.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "image": {
            "x": 96,
            "y": 64,
            "cdn_url": "https://cdn.techhaven.org/xxxxxxxxxxxxxxxxxxxxxxx.png",
            "filename": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.png"
        },
        "linkItem": [ // Not available to all API users
            {
                "id": 1256,
                "name": "Tangent Weaponpart 3",
                "linkType": "part",
                "quantity": 1
            },
            {
                "id": 1258,
                "name": "Tangent Weaponpart 5",
                "linkType": "part",
                "quantity": 1
            },
            {
                "id": 1019,
                "name": "Tangent Weaponpart 2",
                "linkType": "part",
                "quantity": 1
            },
            {
                "id": 396,
                "name": "Metal Plate",
                "linkType": "recycle",
                "quantity": 3
            },
            {
                "id": 418,
                "name": "Wire Junk",
                "linkType": "recycle",
                "quantity": 3
            },
            {
                "id": 395,
                "name": "Metal Pipes",
                "linkType": "recycle",
                "quantity": 1
            }
        ],
        "status": "Imported",
        "attribute": [
            {
                "name": "Dexterity",
                "shortName": "DEX",
                "attributeGroup": "Main Skills",
                "attributeType": "requirement",
                "value": "6.00",
                "formatValue": 6
            },
            {
                "name": "Rifle combat",
                "shortName": "R-C",
                "attributeGroup": "Dexterity",
                "attributeType": "requirement",
                "value": "15.00",
                "formatValue": 15
            },
            {
                "name": "This item is researchable",
                "shortName": "Researchable",
                "attributeGroup": "Item information",
                "attributeType": "tag",
                "value": "1.00",
                "formatValue": "Enabled"
            },
            {
                "name": "Weapon Type",
                "shortName": "Weapon Type",
                "attributeGroup": "Weapon information",
                "attributeType": "tag",
                "value": "45.00",
                "formatValue": "Assault Rifle"
            }
        ],
        "groupReference": 63,
        "id": 1562
    }
}

Items DB API Breaking changes 3.2

Version 3.2 introduces a new set of API endpoints for getting data from the Items DB, and drops getting data via the User UI by adding .json to the endpoint. This means you will have to update your application to use the new endpoints.

Retrieved from "https://wiki.techhaven.org/index.php?title=THNapi:Items_DB_-_JSON_Examples&oldid=17105"