Postman είναι ένα δημοφιλές περιβάλλον δοκιμών API που επιτρέπει την υλοποίηση και τη δοκιμή τελικών σημείων REST API.
Το Postman παρέχει τη δικτύωση HTTP για σύνδεση στο REST API, επιτρέπει την προσαρμογή των κεφαλίδων HTTP και των δεδομένων GET/POST, και επιτρέπει την εκτέλεση προσαρμοσμένου κώδικα χρησιμοποιώντας μια παραλλαγή JavaScript.
Προκαθορισμένες υλοποιήσεις μπορούν να εισαχθούν στο Postman μέσω συλλογών (ουσιαστικά ένα αρχείο JSON που περιέχει τη διαμόρφωση και τον κώδικα για κάθε τελικό σημείο API).
Ακολουθούν δείγματα συλλογών Postman για το spot 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": {}
}