Skip to main content
POST
/
phones
/
{phone_id}
/
tap
Tap
curl --request POST \
  --url https://api.example.com/phones/{phone_id}/tap
Execute a single tap at the specified coordinates.

​
Request

curl -X POST https://api.tapkit.ai/phones/{phone_id}/tap \
  -H "X-API-Key: TK_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200}'

​
Path Parameters

ParameterTypeDescription
phone_idstringThe phone identifier

​
Query Parameters

ParameterTypeDefaultDescription
asyncbooleanfalseReturn immediately with job ID

​
Request Body

{
  "x": 100,
  "y": 200
}
FieldTypeDescription
xintegerX coordinate in pixels
yintegerY coordinate in pixels

​
Response

​
Synchronous

{
  "id": "job_abc123",
  "status": "completed",
  "result": {},
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:30:01Z"
}

​
Asynchronous

{
  "job_id": "job_abc123"
}

​
Examples

​
Basic Tap

curl -X POST https://api.tapkit.ai/phones/abc123/tap \
  -H "X-API-Key: TK_..." \
  -H "Content-Type: application/json" \
  -d '{"x": 585, "y": 1266}'

​
Python Example

import requests

response = requests.post(
    f"https://api.tapkit.ai/phones/{phone_id}/tap",
    headers={
        "X-API-Key": "TK_...",
        "Content-Type": "application/json"
    },
    json={"x": 100, "y": 200}
)

job = response.json()
print(f"Tap completed: {job['status']}")