MeetWho Public API

Networking katmanı üzerine geliştir.

Etkinlik oluşturmak, katılımcıları senkronize etmek ve profilleri okumak için basit bir JSON REST API. Kişisel API anahtarınızla kimlik doğrulanan, /api/public/v1 altındaki same-origin uç noktalar.

Giriş

Temel URL: https://meetwho.app/api/public/v1. Tüm yanıtlar JSON formatındadır ve Cache-Control: no-store başlığıyla döner. Tarayıcı kullanımı için CORS etkindir.

Kimlik Doğrulama

API anahtarları sayfasında bir anahtar oluşturun ve x-meetwho-api-key başlığında gönderin. Anahtarlar mw_live_ ile başlar. Alternatif olarak Authorization: Bearer … de kullanabilirsiniz.

curl https://meetwho.app/api/public/v1/users/me \
  -H "x-meetwho-api-key: mw_live_..."

Hatalar

Hatalar; error.code ve error.message içeren bir JSON gövdesi döner. HTTP durum kodu hata sınıfını yansıtır: 400 hatalı istek, 401 yetkisiz, 404 bulunamadı, 500 sunucu hatası.

{ "error": { "code": "unauthorized", "message": "Invalid API key." } }

Kullanıcılar

GET/users/meKimliği doğrulanmış anahtar sahibinin profilini getirir.

Etkinlikler

GET/eventsEv sahipliği yaptığınız etkinlikleri listeler. ?status=draft|published &limit=1..100

GET/events/:idEv sahipliği yaptığınız bir etkinliği id veya slug ile getirir.

POST/events/createYeni bir etkinlik oluşturur.

curl -X POST https://meetwho.app/api/public/v1/events/create \
  -H "x-meetwho-api-key: mw_live_..." \
  -H "content-type: application/json" \
  -d '{
    "title": "Kurucular Kahvesi",
    "start_at": "2026-08-01T09:00:00Z",
    "end_at":   "2026-08-01T11:00:00Z",
    "timezone": "Europe/Istanbul",
    "location_type": "in_person",
    "location_city": "Istanbul",
    "location_country": "Turkey",
    "visibility": "public"
  }'

Katılımcılar

GET/events/:id/guestsEv sahipliği yaptığınız bir etkinliğin katılımcılarını listeler. ?limit=1..200

OpenAPI

Makine tarafından okunabilir şema: /api/public/v1/openapi. Postman, Insomnia veya tercih ettiğiniz OpenAPI istemcisine içe aktarabilirsiniz.