API TownSpot agus Lorg Eòlaiche

Sgrìobhainnean lorg

Tha na URLan ainmeil seo a’ cuideachadh luchd-eòlaiche agus luchd-ceangail a’ lorg seirbheisean TownSpot gun a bhith a’ cleachdadh beachdan cruaidh.

• /.well-known/api-catalog - https://www.townspot.co/.well-known/api-catalog
• /.well-known/openid-configuration - https://www.townspot.co/.well-known/openid-configuration
• /.well-known/oauth-protected-resource - https://www.townspot.co/.well-known/oauth-protected-resource
• /.well-known/mcp/server-card.json - https://www.townspot.co/.well-known/mcp/server-card.json

MCP poblach airson luchd-cuideachaidh AI

Ceangail ChatGPT, Claude no cliant MCP eile ri TownSpot, an stiùireadh thachartasan ionadail le cumhachd dhaoine. Faighnich dè tha dol air feadh baile-mòr no ann an nàbachd. Chan eil cunntas a dhìth agus chan urrainn dha tachartasan a chruthachadh no a dheasachadh.

• https://api.townspot.co/api/mcp/events
• Còmhdhail: Streamable HTTP iomallach.
• Dearbhadh: chan eil gin.
• Innealan rim faighinn: aithnich baile-mòr no Baile, liostaich Bailtean, faigh Baile, lorg tachartasan foillsichte a rèir baile-mòr no Baile, faigh tachartas agus faigh ionad.
• Tha toraidhean lorg agus mion-fhiosrachadh thachartasan a’ gabhail a-steach amannan ionadail, baile-mòr agus nàbachd shoilleir, bileagan clàir, ceanglaichean canonaigeach TownSpot agus creideas poblach “Air fhaicinn le” nuair a cheadaicheas cead e.
• Crìochan rannsachaidh: suas ri 20 toradh agus raon de 31 latha aig a' char as motha gach iarrtas.
• Tha an ceanglaiche poblach seo airson lorg a-mhàin. Bidh APIan fa leth TownSpot a' làimhseachadh chur-a-steach poblach fo dhìon agus deasachaidhean dearbhte; tha an CLI a' cur sgrùdaidhean in-ghabhail obrachaiche ris.
• Taic: https://www.townspot.co/contact-us

Iarrtas ceangail as lugha:

POST https://api.townspot.co/api/mcp/events
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

APIan cur-a-steach agus obrachaiche

Tha na h-eisimpleirean seo air leth bhon cheanglaiche marketplace phoblach. Tha cur-a-steach stòr tachartais gun ainm ach fo dhìon agus cuingealaichte; feumaidh ath-sgrùdadh agus deasachadh teisteanasan TownSpot iomchaidh.

1. Lorg tachartasan tro liosta tachartais poblach no duilleag baile canonach.
2. Cuir a-steach URL stòr tachartais tro inneal MCP agus cuir iuchair idempotency ris airson ath-dhèanamh sàbhailte.
3. Dèan ath-sgrùdadh no ùrachadh air an tachartas a chaidh a chruthachadh leis an puing ath-sgrùdaidh no innealan MCP le dearbhadh.

Puingichean-phoblach

Tha na puingean seo a’ nochdadh an prìomh uachdar lorg agus sgrìobhadh tachartais airson bailtean, tachartasan, àiteachan, sruthan MCP sgrìobhaidh-gu-cuir a-steach, agus faidhlichean gnìomh.

• https://api.townspot.co/api/locations/list
• https://api.townspot.co/api/locations/get-by-slug
• https://api.townspot.co/api/events/list
• https://api.townspot.co/api/submit/event
• https://api.townspot.co/api/mcp — MCP tools now include submit_event_from_url plus action receipts and idempotency support for write flows.
• https://api.townspot.co/api/submit/event/{uuid}
• https://api.townspot.co/api/events/{uuid}/review
• https://api.townspot.co/api/p/venues/{slug}
• https://api.townspot.co/api/openapi.json
• https://api.townspot.co/api/healthz
• https://api.townspot.co/api/venue-admin/{slug}/events/{eventUuid}

Eisimpleirean iarrtais agus freagairt

Lorg tachartasan poblach airson baile.

GET https://api.townspot.co/api/events/list?zone_id=1&date=2026-05-09

{
  "results": [
    {
      "uuid": "event-uuid",
      "title": "Community market",
      "startTime": "2026-05-09T10:00:00.000Z",
      "venueName": "Town Hall",
      "zoneId": 1
    }
  ]
}

Cuir a-steach tachartas bho URL stòr tro MCP.

POST https://api.townspot.co/api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": "submit-1",
  "method": "tools/call",
  "params": {
    "name": "submit_event_from_url",
    "arguments": {
      "url": "https://example.com/events/community-market",
      "idempotencyKey": "community-market-2026-05-09"
    }
  }
}

Dèan ath-sgrùdadh air tachartas le iarrtas le dearbhadh.

GET https://api.townspot.co/api/events/{uuid}/review
Authorization: Bearer {supabaseJwt}

{
  "event": {
    "uuid": "event-uuid",
    "title": "Community market",
    "status": "ready_for_review"
  },
  "actions": ["approve", "edit", "request_more_info"]
}

Dearbhadh

Bidh APIan rianaire TownSpot agus manaidsear àite air an dìon le tokenan giùlain a tha air an toirt seachad le Supabase Auth.

Cleachd na sgrìobhainnean metadata OpenID Connect agus OAuth gus fiosrachadh mu ùghdarras, token, JWKS, agus goireasan dìon a lorg gu fèin-ghluasadach. Faodaidh innealan cur poblach cuideachd tokenan deasachaidh tachartais, ceanglaichean post-d cur a-steach, no tokenan manaidsear àite a chleachdadh far a bheil an sruth sin ann mu thràth. Faodaidh innealan sgrìobhaidh MCP iuchraichean idempotency a thoirt a-steach agus faidhlichean gnìomh a thoirt air ais gus luchd-eòlaiche a chuideachadh le ath-dhèanamh gu glan.

Pàtranan URL Canonach

• https://www.townspot.co/{countryCode}/{townSlug}
• https://www.townspot.co/event/{eventSlug}-{eventUuid}
• https://www.townspot.co/venue/{venueSlug}