Postman allows you to test your APIs using simple Javascript code. You can evaluate your response body, headers, cookies, and more using the ChaiJS BDD syntax.

This collection guides you through the process of setting up an integration test to ensure that all individual components of an API function together seamlessly.

The API under test in this collection includes three endpoints for registering and receiving a token, accessing your unique generated name, and unregistering a token:

POST /register
\n
POST /unregister
\n
GET /my-name
\n

By setting up requests in the order of the operation, we can test the flow of data to and from the endpoints and ensure they work together as expected. We also verify that the data persists between requests on the back end.

Using this collection

Step 1: Check out the requests' documentation to learn more about -

what each request is meant to do.
\n
the tests we've added against each one.
\n

Step 2: Run this collection by clicking on \"Run\".

\n\n

Step 3: To customize this collection, replace the request URLs with your API endpoints and add or edit the tests if needed.

Resources

Scripting in Postman

Test script examples

Postman Sandbox API reference

Using the Collection Runner

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"About this collection","slug":"about-this-collection"}],"owner":"23523615","collectionId":"fa3ed078-dcfd-4077-bf9f-24d09fae1dab","publishedId":"2sAYJ7hfBS","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-01-02T17:11:16.000Z"},"item":[{"name":"Register","event":[{"listen":"test","script":{"exec":["pm.test(\"An access token is returned\", () => {"," pm.expect(pm.response.json()).to.have.property('token')"," pm.expect(pm.response.json().token).to.be.a('string')"," // Set the collection-scope \"token\" variable to the token received from the API"," // This lets us use it in other requests"," pm.collectionVariables.set('token', pm.response.json().token)","})",""],"type":"text/javascript"}}],"id":"90fc770d-44ca-4c31-a2c3-0f2cca7f6196","request":{"method":"POST","header":[],"url":"https://postman-integration-testing.glitch.me//register","description":"

This returns a token that you can use to retrieve information later on.

We have included a test to confirm if a token is returned. We have also added test scripts to copy the token to the token collection variable. This makes it easy for us to reuse this token in other requests in the collection.

\n","urlObject":{"path":["register"],"host":["https://postman-integration-testing.glitch.me/"],"query":[],"variable":[]}},"response":[],"_postman_id":"90fc770d-44ca-4c31-a2c3-0f2cca7f6196"},{"name":"Get name","event":[{"listen":"test","script":{"exec":["pm.test(\"A name is returned\", () => {"," pm.expect(pm.response.json()).to.have.property('name');"," pm.expect(pm.response.json().name).to.be.a('string');","})"],"type":"text/javascript"}}],"id":"8a453e9c-12d5-41ef-878a-88b3dc830b7e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://postman-integration-testing.glitch.me//my-name?token=","description":"

This request uses the saved token collection variable to access a secret 'name' stored against that token.

In this request, we used the token collection variable as a query param to fetch the name generated for that token. We have added a test to check that a name is correctly returned.

\n","urlObject":{"path":["my-name"],"host":["https://postman-integration-testing.glitch.me/"],"query":[{"key":"token","value":""}],"variable":[]}},"response":[],"_postman_id":"8a453e9c-12d5-41ef-878a-88b3dc830b7e"},{"name":"Unregister","event":[{"listen":"test","script":{"exec":["pm.test(\"Returns 200 OK status\", () => {"," pm.response.to.have.status(200)","})"],"type":"text/javascript"}}],"id":"a4fe4c8f-042d-431b-b6ba-12dfc8ea4f38","request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"token\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://postman-integration-testing.glitch.me//unregister","description":"

This request un-registers a token by using the token collection variable in the POST body.

We also added a test to ensure the response has a 200 OK status code.

\n","urlObject":{"path":["unregister"],"host":["https://postman-integration-testing.glitch.me/"],"query":[],"variable":[]}},"response":[],"_postman_id":"a4fe4c8f-042d-431b-b6ba-12dfc8ea4f38"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""]}},{"listen":"test","script":{"type":"text/javascript","exec":[""]}}],"variable":[{"id":"85d945a3-82e4-40a0-914c-a462cd91b566","key":"token","value":""},{"id":"97f2febe-c190-4e6c-9df0-c62752b87e73","key":"baseUrl","value":"https://postman-integration-testing.glitch.me/"}]}