Example API Documentation


This is an example API documentation. It is not intended to be used in production.


Version

This is an example version section. The current version of the API is 2.0.0.

The previous version of the API is 1.0.0. Documentation for the previous version can be found at:


Contact

This is an example contact section. If you have any technical questions or suggestions, please contact us at:


License

This is an example license section. Please see the license for more information.


Authentication

This is an example authentication section


API Key

This is an example API key authentication section with code snippet. The API key must be provided in the Authorization header of the request as follows:

Authorization: ApiKey <your_api_key>

Endpoints

This is an example endpoints section

POST /api/users

Create User

Parameters

The name of the user

Responses

The user was successfully created


{
	"message": "User created successfully",
	"data": {
		"id": "123",
		"name": "John Doe"
	}
}
				

The user was not created


{
	"message": "User not created"
}
				
GET /api/users/{id}

Get User

Parameters

The user ID

Responses

The user was successfully retrieved


{
	"message": "User retrieved successfully",
	"data": {
		"id": "123",
		"name": "John Doe"
	}
}
				

The user was not found


{
	"message": "User not found"
}
				
PUT /api/users/{id}

Update User

Parameters

The user ID

The name of the user

Responses

The user was successfully updated


{
	"message": "User updated successfully",
	"data": {
		"id": "123",
		"name": "John Doe"
	}
}
				

The user was not updated


{
	"message": "User not updated"
}
				
DELETE /api/users/{id}

Delete User

Parameters

The user ID

Responses

The user was successfully deleted


{
	"message": "User deleted successfully",
	"data": {
		"id": "123",
		"name": "John Doe"
	}
}
				

The user was not deleted


{
	"message": "User not deleted"
}
				
GET /api/users

List Users

Parameters

No parameters

Responses

The users were successfully retrieved


{
	"message": "Users retrieved successfully",
	"data": [{
		"id": "123",
		"name": "John Doe"
	}, {
		"id": "456",
		"name": "Jane Doe"
	}]
}
				

The users were not found


{
	"message": "Users not found"
}