TullyAPI

Fast, simple API testing tool. Now with environment variables and GraphQL!

Now with more bug fixes.

Check out the blog
Back to App

Usage Examples

Learn how to use TullyAPI for common API testing scenarios. From simple GET requests to complex authenticated workflows, these examples will help you get the most out of TullyAPI.

Beginner

1. Testing a Public REST API

Learn the basics by testing a simple public API that returns JSON data without authentication.

Steps:

  1. Click + Add Collection in the sidebar and name it "Public APIs"
  2. Click + Add Endpoint inside your collection
  3. Select GET method and enter path: /users
  4. Set Base URL to: https://jsonplaceholder.typicode.com
  5. Click Send Request
  6. View the JSON response with user data
Beginner

2. Creating Resources with POST

Send data to an API using POST requests with a JSON body to create new resources.

Steps:

  1. Create a new endpoint with POST method and path: /posts
  2. Set Base URL to: https://jsonplaceholder.typicode.com
  3. Go to the Body tab
  4. Enter JSON: 
    {
  "title": "My First Post",
  "body": "This is the content",
  "userId": 1
}
  5. Click Send Request
  6. View the created resource in the response with an assigned ID
Intermediate

3. Using Bearer Token Authentication

Test APIs that require Bearer token authentication (common with JWT-based APIs).

Steps:

  1. Create a new endpoint (e.g., GET /api/protected)
  2. Go to the Auth tab
  3. Select Bearer Token from the dropdown
  4. Paste your API token in the token field
  5. Click Send Request
  6. TullyAPI automatically adds the Authorization: Bearer YOUR_TOKEN header
Beginner

4. Adding Query Parameters

Filter, search, or paginate API results using query parameters.

Steps:

  1. Create endpoint: GET /posts with base URL https://jsonplaceholder.typicode.com
  2. Go to the Query Params tab
  3. Click + Add Parameter
  4. Add: userId = 1
  5. Add another: _limit = 5
  6. Click Send Request
  7. See filtered results for user 1, limited to 5 posts
Intermediate

5. Setting Custom Headers

Add custom HTTP headers for API keys, content types, or other requirements.

Steps:

  1. Create your endpoint
  2. Go to the Headers tab
  3. Click + Add Header
  4. Add header: X-API-Key with your API key value
  5. Add header: Accept with value application/json
  6. Click Send Request
  7. The API receives your custom headers
Intermediate

6. Testing CRUD Operations

Test a full CRUD (Create, Read, Update, Delete) workflow using different HTTP methods.

Steps:

  1. Create: POST /posts with JSON body
  2. Read: GET /posts/1 to fetch the created post
  3. Update: PUT /posts/1 with updated JSON body
  4. Partial Update: PATCH /posts/1 with partial data
  5. Delete: DELETE /posts/1 to remove the post
  6. Organize all these endpoints in a "CRUD Tests" collection
Beginner

7. Organizing Endpoints with Collections

Keep your API tests organized by grouping related endpoints into collections.

Best Practices:

  1. Create separate collections for different services (e.g., "User API", "Payment API", "Auth API")
  2. Use descriptive endpoint names like "Login", "Get User Profile", "Update Settings"
  3. Keep development and production endpoints in separate collections
  4. Export collections to share with your team
  5. Import collections to quickly set up testing environments
Intermediate

8. Tracking API Performance

Use TullyAPI's built-in performance tracking to monitor response times and identify slow endpoints.

Steps:

  1. Send multiple requests to the same endpoint
  2. After each request, check the response time displayed next to the status code
  3. Go to the Chart tab in the response section
  4. View a line chart showing response times for your last requests
  5. Look for patterns or spikes that indicate performance issues
  6. Use this data to optimize slow endpoints
Intermediate

9. Basic Authentication

Test APIs that use Basic Authentication with username and password.

Steps:

  1. Create your endpoint
  2. Go to the Auth tab
  3. Select Basic Auth
  4. Enter your username and password
  5. Click Send Request
  6. TullyAPI automatically encodes credentials and adds the Authorization header
Beginner

10. Exporting and Sharing Collections

Export your API collections to share with team members or back up your work.

Steps:

  1. Click the download icon in the Collections header
  2. A JSON file will be downloaded with all your collections and endpoints
  3. Share this file with your team via email, Slack, or file sharing
  4. Team members can click the upload icon to import your collections
  5. All endpoints, settings, and configurations are preserved
  6. Warning: Exported files may contain API keys - share securely!

Ready to Start Testing?

Try these examples yourself and discover how TullyAPI makes API testing simple and fast.

Open TullyAPI