Customers

Interventions

2 نقاط نهايةREST / JSON

نظرة عامة

استخدم المسارات والطرق أدناه. استبدل معرفات المثال وYOUR_API_TOKEN بقيمك المصرح بها؛ هذه الصفحة لا تنفذ الأمثلة مطلقًا.

عنوان URL الأساسي

https://api.stayclean.io

المصادقة

Authorization: Basic YOUR_API_TOKEN

GET/api/v1/interventions

عرض التدخلات

يرجع جميع تدخلات التنظيف.

المعلمات

المعلمة	النوع	الموقع	مطلوب	التفاصيل
page	integer	الاستعلام	لا	رقم الصفحة (الافتراضي: 1).`1`
limit	integer	الاستعلام	لا	عدد النتائج في الصفحة (الحد الأقصى: 100).`25`
sort	string	الاستعلام	لا	ترتيب تاريخ التدخل (asc أو desc، الافتراضي: desc).`desc`

مصادقة API مطلوبة.

حدود الطلبات:60 / دقيقة1200 / ساعة4800 / يوم

مثال الطلب · GET

cURL

curl --request 'GET' 'https://api.stayclean.io/api/v1/interventions?page=1&limit=25&sort=desc' \
  --header 'Authorization: Basic YOUR_API_TOKEN' \
  --header 'Accept: application/json'

JavaScript

const response = await fetch("https://api.stayclean.io/api/v1/interventions?page=1&limit=25&sort=desc", {
    "method": "GET",
    "headers": {
        "Authorization": "Basic YOUR_API_TOKEN",
        "Accept": "application/json"
    }
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();

PHP

<?php
$curl = curl_init('https://api.stayclean.io/api/v1/interventions?page=1&limit=25&sort=desc');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => array (
  0 => 'Authorization: Basic YOUR_API_TOKEN',
  1 => 'Accept: application/json',
),
]);
$response = curl_exec($curl);
if ($response === false) throw new RuntimeException(curl_error($curl));
curl_close($curl);
$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);

PYTHON

import json
from urllib.request import Request, urlopen

headers = {
    "Authorization": "Basic YOUR_API_TOKEN",
    "Accept": "application/json"
}
data = None
request = Request("https://api.stayclean.io/api/v1/interventions?page=1&limit=25&sort=desc", data=data, headers=headers, method="GET")
with urlopen(request) as response:
    result = json.load(response)

مثال الاستجابة

{
    "metadata": {
        "page": 1,
        "limit": 25,
        "total_items": 120,
        "total_pages": 5,
        "sort": "desc"
    },
    "nodes": [
        {
            "id": "6dfc7a2e-8f9a-4a0f-9bd0-3f5a7d123456",
            "status": "pending",
            "scheduled_at": "2024-06-01T08:00:00+10:00",
            "property": {
                "id": "6dfc7a2e-8f9a-4a0f-9bd0-3f5a7d123456",
                "name": "Villa Moana"
            },
            "is_started": false,
            "booking": {
                "id": "e9d3a5c2-04bf-4a76-9f79-8db3bfc69f8e",
                "guest": "Jane Doe"
            },
            "invoice": {
                "id": "f6a9c1f2-5d7b-4a2d-b1b2-0a7c0d61bcd1"
            },
            "live": {
                "status": "pending",
                "is_done": false,
                "is_validated": false,
                "started_at": null,
                "ended_at": null,
                "is_paid": false
            },
            "accounting": {
                "amount": null,
                "paid_at": null
            }
        }
    ]
}

GET/api/v1/interventions/{id}

جلب تدخل

يرجع تفاصيل تدخل محدد.