LeyAppkwa Wasanidi Programu

Muhtasari

YaAPI hufichua data sawa ya wakili aliyethibitishwa kamaleyapp.es : utafutaji, wasifu wa umma, mapitio, upatikanaji, na nia za kuweka nafasi. Ufikiaji usiojulikana hufanya kazi kwa viwango vya chini vya bei;API ufunguo huongeza mipaka na kufungua sehemu za mwisho zenye ufunguo na uchanganuzi wa matumizi.

Anza haraka

Kuanzia sifuri hadi nia ya kuweka nafasi (ya majaribio) katika maombi manne. Unda ufunguo wa majaribio bila malipo katika Dashibodi → Msanidi programu kwanza.

# 1. Get a test key at leyapp.es/dashboard/developer
export LEYAPP_API_KEY="leyk_test_..."

# 2. Find a lawyer
curl "https://leyapp.es/api/v1/lawyers/search?city=Barcelona&practice_area=immigration" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

# 3. Check availability (id from step 2)
curl "https://leyapp.es/api/v1/lawyers/<lawyer_id>/availability" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

# 4. Create a (test) booking intent
curl -X POST "https://leyapp.es/api/v1/bookings/initiate" \
  -H "Authorization: Bearer $LEYAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-1" \
  -d '{"lawyer_id":"<lawyer_id>","date":"<date>","start_time":"09:00:00","end_time":"10:00:00"}'

Uthibitishaji

Tuma ufunguo wako kama tokeni ya Mbebaji kwa kila ombi:

Authorization: Bearer leyk_...

• Funguo huja katika matoleo ya moja kwa moja (leyk_) na majaribio (leyk_test_) na huonyeshwa mara moja tu wakati wa uundaji — zihifadhi katika kidhibiti siri.
• Kamwe usitume ufunguo katika msimbo wa upande wa mteja au hazina ya umma. Zungusha kwa kuunda ufunguo mpya, kuutumia, kisha ubatilishe ule wa zamani (hakuna muda wa kutofanya kazi).
• Kufuta ni papo hapo. Funguo zilizopotea haziwezi kupatikana — zinaweza kubadilishwa tu.
• Tokeni za MCP (ley_...) huthibitisha wasaidizi wa AI kwenye /api/mcp na si halali kwenye RESTAPI .

Vikomo vya viwango

Maombi yenye ufunguo hupata mipaka ya kiwango (dirisha mbili: mlipuko wa kila dakika + mgao wa kila siku) yenye vichwa vya habari vya X-RateLimit-Limit, X-RateLimit-Remaining na X-RateLimit-Reset. Kwenye 429, heshimu Retry-After na ujaribu tena kwa kurudi nyuma kwa kielelezo cha jittered.

Funguo mpya huanza kwenye daraja huru. Daraja za washirika hutolewa naLeyApp timu — wasiliana nasi kupitia fomu ya usaidizi ikiwa ujumuishaji wako unahitaji nafasi zaidi ya uongozi. Maombi yasiyojulikana hutumia mipaka tofauti na ya chini kwa kila IP.

Hali ya majaribio

Funguo za majaribio (leyk_test_) hutenda kama funguo za moja kwa moja — sehemu za mwisho zinazofanana, uthibitisho sawa, maumbo ya majibu sawa — lakini hakuna kinachotokea halisi: hakuna nia ya kuweka nafasi inayohifadhiwa, hakuna wakili anayearifiwa, hakuna kinachoweza kuthibitishwa au kulipwa.

Trafiki ya majaribio inaonekana kwenye kumbukumbu ya ombi la dashibodi yako (iliyotiwa alama) lakini haijajumuishwa kwenye mkusanyiko wa kila siku. Badilisha ufunguo kwa ule wa moja kwa moja unaposafirisha — hakuna mabadiliko mengine yanayohitajika.

Sehemu za Mwisho

curl "https://leyapp.es/api/v1/lawyers/search?city=Barcelona&practice_area=immigration&language=en" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/lawyers/<lawyerId>" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/lawyers/<lawyerId>/availability" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/lawyers/<lawyerId>/reviews" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/practice-areas" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

curl "https://leyapp.es/api/v1/cities" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

{
  "lawyer_id": "<lawyer_id from search>",
  "date": "2026-09-01",
  "start_time": "09:00:00",
  "end_time": "10:00:00",
  "source": "api",
  "agent_name": "MyIntegration"
}

curl -X POST "https://leyapp.es/api/v1/bookings/initiate" \
  -H "Authorization: Bearer $LEYAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lawyer_id":"<lawyer_id from search>","date":"2026-09-01","start_time":"09:00:00","end_time":"10:00:00","source":"api","agent_name":"MyIntegration"}'

curl "https://leyapp.es/api/v1/booking-intents/<intentId>" \
  -H "Authorization: Bearer $LEYAPP_API_KEY"

Viunganishi vya wavuti

Jisajili kwenye sehemu ya mwisho ya HTTPS (Dashibodi → Msanidi Programu → Webhooks) kwa matukio ya nia ya kuweka nafasi yaliyoundwa kwa kutumia ufunguo wako. Uwasilishaji hufuata vipimo vya Standard Webhooks na hujaribiwa tena kiotomatiki.

• Matukio: booking_intent.confirmed / booking_intent.expired (hatua ya nia), pamoja na mzunguko kamili wa maisha ya uhifadhi kwaAPI -uhifadhi ulioanzishwa — uhifadhi.imeidhinishwa, uhifadhi.imeghairiwa, uhifadhi.imekamilika.
• Thibitisha kila uwasilishaji kwa kutumia siri ya kusaini ya whsec_ inayoonyeshwa mara moja wakati wa uundaji wa mwisho — maktaba rasmi za standardwebhooks hufanya hivi kwa simu moja. Kataa mihuri ya muda iliyo na zaidi ya dakika ±5.
• Uwasilishaji ni angalau mara moja: hutolewa na kichwa cha habari cha webhook-id (pia kitambulisho cha mzigo). Malipo yana vitambulisho na hali pekee — pata maelezo kutokaAPI kama unazihitaji.

# Delivery headers (Standard Webhooks — standardwebhooks.com):
#   webhook-id:        unique delivery id (dedup key — at-least-once delivery)
#   webhook-timestamp: unix seconds (reject if older than ±5 minutes)
#   webhook-signature: v1,<base64 HMAC-SHA256 of "{id}.{timestamp}.{body}">
#
# Payload: { "id": "...", "type": "booking_intent.confirmed",
#            "created_at": "...", "data": { "booking_intent_id": "...", "status": "..." } }
# Events: booking_intent.confirmed | booking_intent.expired
# Retries: 1m / 5m / 30m / 2h / 12h, then dead. Endpoint auto-disabled
# after 20 consecutive failures.

Mawakala wa MCP na AI

Unapendelea kuzungumza badala ya kuandika msimbo?LeyApp husafirisha seva ya MCP yenye zana 15 — utafutaji, upatikanaji, uhifadhi, na (kwa idhini yako) uhifadhi wako mwenyewe — kwa Claude, ChatGPT, Kielekezi na mteja yeyote mwenye uwezo wa MCP.OAuth idhini yenye viwango vya ruhusa vya chembechembe; ondoa wakati wowote kutoka kwa Dashibodi → Msanidi Programu.

Settings → Connectors → Add custom connector
Name: LeyApp
URL:  https://leyapp.es/api/mcp/mcp

Claude opens the LeyApp consent screen — sign in, pick a
permission level, and you're connected.

Logo ya mabadiliko

V1API ni nyongeza pekee: sehemu zinaongezwa, hazibadilishwi jina au kuondolewa. Mabadiliko yanayovunjika yangetumwa kama toleo jipya lenye dirisha la siku 90 la kuondoa huduma lililotangazwa hapa na kupitia vichwa vya habari vya Kuondoa Huduma/Kutua kwa Jua.