Welcome to the API reference for Quantum Entanglement Services (QES). This section details the available endpoints for interacting with our quantum entanglement infrastructure.
Core Endpoints
POST /v1/entangle
Initiates a new entangled particle pair. You will receive two unique particle IDs upon successful creation.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| particle_type | string | Yes | Specifies the type of particle to entangle (e.g., "photon", "electron"). |
| entanglement_mode | string | No | Optional. Defines the entanglement state (e.g., "spin", "polarization"). Defaults to "spin". |
Successful Response (201 Created):
{
"message": "Entangled pair created successfully.",
"particle_id_a": "qep-a-8b3c1d9e-f0a1-4b2c-8d3e-5f6a7b8c9d0e",
"particle_id_b": "qep-b-a1b2c3d4-e5f6-7890-1234-567890abcdef"
}
GET /v1/particles/{particle_id}
Retrieves the current state and properties of a specific entangled particle.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| particle_id | string | Yes | The unique identifier for the particle. |
Successful Response (200 OK):
{
"message": "Particle state retrieved.",
"particle_id": "qep-a-8b3c1d9e-f0a1-4b2c-8d3e-5f6a7b8c9d0e",
"entangled_with": "qep-b-a1b2c3d4-e5f6-7890-1234-567890abcdef",
"state": "superposition",
"properties": {
"spin": "+1/2",
"polarization": "horizontal"
},
"last_measured": "2023-10-27T10:00:00Z"
}
Error Response (404 Not Found):
{
"error": "Particle not found.",
"particle_id": "invalid-particle-id"
}
POST /v1/measure
Measures the state of one particle in an entangled pair. This action collapses the superposition of both particles.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| particle_id | string | Yes | The ID of the particle to measure. |
| measurement_axis | string | No | Optional. The axis along which to perform the measurement (e.g., "z-axis", "x-axis"). Defaults to the default axis for the particle type. |
Successful Response (200 OK):
{
"message": "Measurement successful.",
"measured_particle_id": "qep-a-8b3c1d9e-f0a1-4b2c-8d3e-5f6a7b8c9d0e",
"result": "+1/2",
"collapsed_state": "spin_up",
"correlated_particle_id": "qep-b-a1b2c3d4-e5f6-7890-1234-567890abcdef",
"correlated_result": "-1/2"
}
Utility Endpoints
GET /v1/status
Provides the current operational status of the QES platform.
Successful Response (200 OK):
{
"status": "operational",
"timestamp": "2023-10-27T10:05:00Z",
"load_percentage": 45.7
}