Husly API

API kuulub Agency-paketti. Võtme saab luua konto omanik: Minu konto -> API-võtmed. Täisvõtit näidatakse ainult ÜHEL korral - salvesta see kohe.

# Who am I? Returns the account id and the key's scopes.
curl https://api.husly.app/api/v1/me \
  -H "Authorization: Bearer hsly_live_ab12cd34ef56_..."

# List the sites on this account.
curl https://api.husly.app/api/v1/sites \
  -H "Authorization: Bearer hsly_live_ab12cd34ef56_..."

Authorization: Bearer hsly_live_ab12cd34ef56_XXXXXXXXXXXXXXXXXXXXXXXX

# or

X-Api-Key: hsly_live_ab12cd34ef56_XXXXXXXXXXXXXXXXXXXXXXXX

Ära pane võtit brauseris jooksvasse koodi ega avalikku repositooriumi - see annab ligipääsu kogu kontole. Hoia seda serveri keskkonnamuutujas. Lekkinud võtme saab kohe tühistada ja uue luua.

curl -X POST https://api.husly.app/api/v1/sites/SITE_ID/posts \
  -H "Authorization: Bearer hsly_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "kevadised-pakkumised",
    "title":   { "et": "Kevadised pakkumised", "en": "Spring offers" },
    "excerpt": { "et": "Lühike sissejuhatus.", "en": "A short intro." },
    "status": "published",
    "authorName": "Mari Maasikas",
    "layoutJson": {
      "contentWidth": "narrow",
      "blocks": [
        { "id": "b1", "type": "richtext", "props": {
            "content": { "et": "<p>Tere tulemast!</p>", "en": "<p>Welcome!</p>" } } }
      ]
    }
  }'

Praegune versioon on v1. Me ei muuda v1 vastuste kuju viisil, mis su integratsiooni katki teeb - uued väljad võivad lisanduda, olemasolevad ei kao. Murrav muudatus tähendaks uut teed (/api/v2/).

Partneri võti algab eesliitega hsly_partner_ ja töötab ainult aadressil /api/partner/v1/rentals. Konto API võti (hsly_live_) siin ei tööta, ja partneri võti ei tööta konto API-s.

# The site, its terms, and what this key may do.
curl https://api.husly.app/api/partner/v1/rentals/me \
  -H "Authorization: Bearer hsly_partner_ab12cd34ef56_..."

# What is free from 12 to 14 June, with the lowest price.
curl "https://api.husly.app/api/partner/v1/rentals/listings?from=2027-06-12&to=2027-06-14" \
  -H "Authorization: Bearer hsly_partner_ab12cd34ef56_..."

# Hold a car for 20 minutes...
curl -X POST https://api.husly.app/api/partner/v1/rentals/bookings \
  -H "Authorization: Bearer hsly_partner_ab12cd34ef56_..." \
  -H "Content-Type: application/json" \
  -d '{
    "listing": "toyota-rav4",
    "from": "2027-06-12",
    "to": "2027-06-14",
    "guest": { "name": "Mari Maasikas", "email": "[email protected]", "phone": "+372 5555 5555" },
    "termsAccepted": true,
    "hold": true,
    "reference": "AG-10442"
  }'

# ...and book it once the traveller says yes.
curl -X POST https://api.husly.app/api/partner/v1/rentals/bookings/BOOKING_ID/confirm \
  -H "Authorization: Bearer hsly_partner_ab12cd34ef56_..."

"hold": true hoiab kuupäevi 20 minutit (kuni 60) ega kirjuta kellelegi. POST /bookings/:id/confirm teeb sellest broneeringu; kinnitamata hoidmine vabastab kuupäevad ise. Sama "reference" uuesti saates saad sama broneeringu, mitte teist. Hind ja vabad päevad on samad mis rendiettevõtte enda lehel. Partneri broneeringut Huslys ei maksta: raha arveldab partner rentijaga.

{
  "mcpServers": {
    "husly-rentals": {
      "type": "http",
      "url": "https://api.husly.app/api/partner/v1/rentals/mcp",
      "headers": {
        "Authorization": "Bearer hsly_partner_ab12cd34ef56_..."
      }
    }
  }
}

Kõik väljad ja vastuste kujud on partneri API oma juhendis ja OpenAPI 3.1 failis, mille saab tõmmata Postmani või kliendi genereerimiseks.

Valmis alustama?

API kuulub Agency-paketti. Kui sul on juba konto, loo võti mõne klikiga.