REST API Postman collections (Spot)

Sidst opdateret: 1. april 2025

Postman er et populært API-testmiljø, der gør det muligt at implementere og teste REST API-slutpunkter.

Postman leverer HTTP-netværket til at oprette forbindelse til REST API'en, tillader tilpasning af HTTP-headers og GET/POST-data og muliggør udførelse af brugerdefineret kode ved hjælp af en JavaScript-variant.

Foruddefinerede implementeringer kan importeres til Postman via collections (i bund og grund en JSON-fil, der indeholder konfigurationen og koden for hvert API-slutpunkt).

Følgende er eksempler på Postman collections til vores spot REST API:

Bemærk, at ovenstående collections er beregnet som en demonstration af API-brug, og de implementerer derfor ikke alle mulige inputparametre. Yderligere slutpunkter og parametre kan tilføjes til collections ved at gennemgå den relevante API-dokumentation og bruge de angivne slutpunkter/parametre som eksempler.

Til hurtig reference er følgende et eksempel på JSON-indholdet i en Postman collection:

bash

Bash

{
  "info": {
    "_postman_id": "b530d6e8-8aa3-403d-b8ab-1665d4606eab",
    "name": "Kraken REST API - GetWebSocketsToken Endpoint",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "GetWebSocketsToken",
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "id": "e11ed019-722d-4ecf-8ddf-1f724e5b1ab4",
            "exec": [
              "api_key = \"API PUBLIC KEY\"",
              "api_secret = CryptoJS.enc.Base64.parse(\"API PRIVATE KEY\");",
              "api_nonce = (Date.now() * 1000).toString();",
              "api_endpoint = \"/0/private/GetWebSocketsToken\";",
              "api_post = \"nonce=\" + api_nonce;",
              "",
              "api_sha256 = CryptoJS.SHA256(api_nonce + api_post);",
              "api_sign = CryptoJS.algo.HMAC.create(CryptoJS.algo.SHA512, api_secret);",
              "api_sign.update(api_endpoint, api_secret);",
              "api_sign.update(api_sha256, api_secret);",
              "api_sign = api_sign.finalize().toString(CryptoJS.enc.Base64);",
              "",
              "pm.globals.set(\"api_nonce\", api_nonce);",
              "pm.globals.set(\"api_key\", api_key);",
              "pm.globals.set(\"api_signature\", api_sign);"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "auth": {
          "type": "noauth"
        },
        "method": "POST",
        "header": [
          {
            "key": "API-Key",
            "type": "text",
            "value": "{{api_key}}"
          },
          {
            "key": "API-Sign",
            "type": "text",
            "value": "{{api_signature}}"
          }
        ],
        "body": {
          "mode": "urlencoded",
          "urlencoded": [
            {
              "key": "nonce",
              "value": "{{api_nonce}}",
              "type": "text"
            }
          ]
        },
        "url": {
          "raw": "https://api.kraken.com/0/private/GetWebSocketsToken",
          "protocol": "https",
          "host": [
            "api",
            "kraken",
            "com"
          ],
          "path": [
            "0",
            "private",
            "GetWebSocketsToken"
          ]
        }
      },
      "response": []
    }
  ],
  "protocolProfileBehavior": {}
}

Har du brug for mere hjælp?