API Reference

Base URL

https://api.testra.ai/v1

---

Authentication

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

---

Server Discovery

Search Servers

GET /servers/search?q={query}&category={category}&tags={tags}

Query Parameters

Parameter	Type	Description
q	string	Search query string
category	string	Server category (e.g., defi, gaming)
tags	array	Filter by tags (e.g., price-oracle)
transport	string	Transport protocol filter (http, websocket)
minUptime	number	Minimum uptime percentage (0–100)
maxResponseTime	number	Max response time in milliseconds
audited	boolean	Filter only audited servers
openSource	boolean	Filter only open source servers
limit	number	Number of results per page (max 100)
offset	number	Pagination offset

Example

curl "https://api.testra.ai/v1/servers/search?category=defi&tags=price-oracle&minUptime=99" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "servers": [
    {
      "id": "srv_price_oracle_v1",
      "name": "DeFi Price Oracle",
      "description": "Real-time cryptocurrency price feeds",
      "category": "defi",
      "tags": ["price-oracle", "defi", "ethereum"],
      "transport": ["http", "websocket"],
      "uptime": 99.8,
      "responseTime": 120,
      "lastUpdated": "2025-06-30T14:00:00Z",
      "audited": true,
      "openSource": true,
      "endpoint": "https://price-oracle.example.com"
    }
  ],
  "pagination": {
    "total": 156,
    "limit": 10,
    "offset": 0,
    "hasNext": true
  }
}

---

Get Server Details

Retrieve detailed metadata for a single server.

Request

GET /servers/{serverId}

Example

curl "https://api.testra.ai/v1/servers/srv_price_oracle_v1" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Returns the detailed metadata and status of the server.

---

Server Testing

Run Tests on Server

Send a request to run diagnostic tests on the specified server.

Request

POST /servers/{serverId}/test

Request Body

{
  // JSON describing test parameters (e.g. sample inputs)
}

Example

curl -X POST "https://api.testra.ai/v1/servers/srv_price_oracle_v1/test" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
        "input": {
          "currencyFrom": "USD",
          "currencyTo": "EUR"
        }
      }'

Response Returns the results of test runs including response times, errors, or output samples.