Add post_user_test
parent
fed460b9f6
commit
2b5f8c67f3
42
post_user_test.md
Normal file
42
post_user_test.md
Normal file
@ -0,0 +1,42 @@
|
||||
# Create Test API Endpoint
|
||||
|
||||
## POST `/api/post_test`
|
||||
|
||||
Post Test Data This API endpoint allows you to post test data, recording the results of a test taken by a user.
|
||||
|
||||
## Request Parameters
|
||||
|
||||
- `testType` - Type of the test ("words", "time", "quote", etc)
|
||||
- `testLength` - Length of the test in number of items or
|
||||
- `testTime` - Duration of the test in seconds
|
||||
- `testSeed` - Seed for generating randomized test content
|
||||
- `quoteId` - Identifier for a specific quote, if applicable
|
||||
- `wpm` - Words per minute (typing speed)
|
||||
- `accuracy` - Accuracy of responses (e.g., percentage)
|
||||
- `userId` - Identifier of the user taking the test
|
||||
- `secret` - Secret key for authentication and authorization
|
||||
|
||||
## Responses
|
||||
|
||||
- `200 OK` - The test has been added to the database sucessfully
|
||||
- `401 UNAUTHORIZED` - The user has not been authenticated correctly
|
||||
- `500 INTERNAL SERVER ERROR` - There has been a database error when attempting to
|
||||
|
||||
## Example Request
|
||||
|
||||
```bash
|
||||
curl -X POST "https://example.com/api/post_test" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"testType": "typing",
|
||||
"testLength": 100,
|
||||
"testTime": 600,
|
||||
"testSeed": "random_seed_123",
|
||||
"quoteId": "quote_456",
|
||||
"wpm": 65.5,
|
||||
"accuracy": 98.2,
|
||||
"userId": "user_789",
|
||||
"secret": "your_secret_key_here"
|
||||
}'
|
||||
```
|
||||
|
Loading…
Reference in New Issue
Block a user