Postman — це популярне середовище для тестування API, яке дозволяє впроваджувати та тестувати кінцеві точки REST API.
Postman забезпечує HTTP-мережу для підключення до REST API, дозволяє налаштовувати HTTP-заголовки та дані GET/POST, а також дозволяє виконувати власний код за допомогою варіанту JavaScript.
Попередньо визначені реалізації можна імпортувати в Postman через колекції (по суті, JSON-файл, що містить конфігурацію та код для кожної кінцевої точки API).
Нижче наведено зразки колекцій Postman для нашого спотового REST API:
Зауважте, що наведені вище колекції призначені для демонстрації використання API, тому вони не реалізують кожен можливий вхідний параметр. Додаткові кінцеві точки та параметри можна додати до колекцій, переглянувши відповідну документацію API та використовуючи надані кінцеві точки/параметри як приклади.
Для швидкої довідки нижче наведено приклад вмісту JSON у колекції Postman:
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": {}
}