Grup dersleri API

Kontenjan, eğitmen, rezervasyon ve yoklamayla haftalık ders programı.

Modül kodu group_classes · 12 işlem · 4 veri modeli · 11 olay. Bir anahtar ya da token, arkasındaki kişinin bu modülde yapabildiğinden fazlasını asla yapamaz; satır düzeyindeki güvenlik uygulamadakiyle birebir aynıdır. Yetki kapsamları: group_classes (hepsi), group_classes:read (yalnız okuma) ya da group_classes:<yetenek>.

Kaynaklar

Listeler limit (en çok 200), cursor, order (ör. -created_at), fields ve q alır; diğer her sorgu parametresi bir sütun süzgecidir: ?status=paid, ?total[gte]=100, ?id[in]=a,b, ?x=null.

İşlemler

group_classes.add_schedule

Haftalık saat ekle — Yeni bir seri başlatır: ders her hafta bu gün ve saatte yapılır.

Gereken izin group_classes:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/group_classes.add_schedule

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.series_created

Neye yazar: group_class_schedule (insert) — Writes the series

curl -X POST https://app.getera.io/api/v1/group_class_schedules/actions/add_schedule \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"groupClassId":"GROUP_CLASS_ID","weekday":1,"startTime":"Starts","duration":1}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.series_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClassSchedules.addSchedule({
  groupClassId: "GROUP_CLASS_ID",
  weekday: 1,
  startTime: "Starts",
  duration: 1
})

era group_class_schedules add_schedule \
  --group-class-id "GROUP_CLASS_ID" \
  --weekday 1 \
  --start-time "Starts" \
  --duration 1

{
  "name": "era__group_classes__add_schedule",
  "arguments": {
    "groupClassId": "GROUP_CLASS_ID",
    "weekday": 1,
    "startTime": "Starts",
    "duration": 1
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, class_archived, no_schedule, schedule_exists, service_not_offered_that_day, provider_cannot_perform · 429 çok sık istek

group_classes.archive_class

Dersi kaldır — Rezervasyon almayı durdurur. Geçmiş kalır.

Gereken izin group_classes:manage · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır) · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/group_classes.archive_class

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.class_archived

Neye yazar: group_class (update) — Stamps archived_at; group_class_schedule (update) — Ends every running series today

curl -X POST https://app.getera.io/api/v1/group_classes/GROUP_CLASSE_ID/actions/archive_class \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.class_archived"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClasses.archiveClass("GROUP_CLASSE_ID")

era group_classes archive_class GROUP_CLASSE_ID

{
  "name": "era__group_classes__archive_class",
  "arguments": {
    "id": "GROUP_CLASSE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, class_archived, has_upcoming_joinings, no_workspace · 429 çok sık istek

group_classes.cancel_joining

Ders rezervasyonunu iptal et — Yeri boşaltır. Neden zorunludur.

Gereken izin group_classes:write · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/group_classes.cancel_joining

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.joining_cancelled

Neye yazar: group_class_joining (update) — Marks it cancelled and records why

curl -X POST https://app.getera.io/api/v1/group_class_joinings/GROUP_CLASS_JOINING_ID/actions/cancel_joining \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"reason":"Reason"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.joining_cancelled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClassJoinings.cancelJoining("GROUP_CLASS_JOINING_ID", {
  reason: "Reason"
})

era group_class_joinings cancel_joining GROUP_CLASS_JOINING_ID \
  --reason "Reason"

{
  "name": "era__group_classes__cancel_joining",
  "arguments": {
    "joiningId": "GROUP_CLASS_JOINING_ID",
    "reason": "Reason"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 joining_not_found, already_cancelled, already_finished, unknown_reason · 429 çok sık istek

group_classes.cancel_session

Tek seansı iptal et — Bir tarihi seriden çıkarır ve o seansa kayıtlı herkesi iptal eder.

Gereken izin group_classes:manage · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/group_classes.cancel_session

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.session_cancelled, group_classes.joining_cancelled

Neye yazar: group_class_session_cancellation (insert) — Records the cancelled date; group_class_joining (update) — Cancels everyone booked on it

curl -X POST https://app.getera.io/api/v1/group_class_joinings/actions/cancel_session \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"scheduleId":"GROUP_CLASS_SCHEDULE_ID","sessionDate":"2026-11-02","reason":"Reason"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.session_cancelled",
    "group_classes.joining_cancelled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClassJoinings.cancelSession({
  scheduleId: "GROUP_CLASS_SCHEDULE_ID",
  sessionDate: "2026-11-02",
  reason: "Reason"
})

era group_class_joinings cancel_session \
  --schedule-id "GROUP_CLASS_SCHEDULE_ID" \
  --session-date "2026-11-02" \
  --reason "Reason"

{
  "name": "era__group_classes__cancel_session",
  "arguments": {
    "scheduleId": "GROUP_CLASS_SCHEDULE_ID",
    "sessionDate": "2026-11-02",
    "reason": "Reason"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 schedule_not_found, not_found, unknown_reason, no_such_session, session_cancelled, session_in_past, no_workspace · 429 çok sık istek

group_classes.create_class

Ders oluştur — Hizmetleri, kontenjanı ve haftalık saatleriyle bir ders, tek seferde.

Gereken izin group_classes:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/group_classes.create_class

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.class_created

Neye yazar: group_class (insert) — Creates the class; group_class_service (insert) — Links its services; group_class_schedule (insert) — Writes its weekly series

curl -X POST https://app.getera.io/api/v1/group_classes/actions/create_class \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Name","capacity":1,"itemVariantIds":{},"schedules":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.class_created"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClasses.createClass({
  name: "Name",
  capacity: 1,
  itemVariantIds: {},
  schedules: {}
})

era group_classes create_class --data '{"name":"Name","capacity":1,"itemVariantIds":{},"schedules":{}}'

{
  "name": "era__group_classes__create_class",
  "arguments": {
    "name": "Name",
    "capacity": 1,
    "itemVariantIds": {},
    "schedules": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 no_services, no_schedule, service_not_found, not_a_class_service, service_not_offered_that_day, provider_cannot_perform, schedule_exists · 429 çok sık istek

group_classes.end_schedule

Seriyi bitir — Ders bir tarihten sonra bu saatte yapılmaz; sonraki rezervasyonlar iptal edilir.

Gereken izin group_classes:manage · dışarıya ulaşır (gönderir, yayımlar ya da ücret alır) · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/group_classes.end_schedule

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.series_ended, group_classes.joining_cancelled

Neye yazar: group_class_schedule (update) — Stamps ends_on; group_class_joining (update) — Cancels bookings after the last session

curl -X POST https://app.getera.io/api/v1/group_class_schedules/GROUP_CLASS_SCHEDULE_ID/actions/end_schedule \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"endsOn":"2026-11-02","reason":"Reason"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.series_ended",
    "group_classes.joining_cancelled"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClassSchedules.endSchedule("GROUP_CLASS_SCHEDULE_ID", {
  endsOn: "2026-11-02",
  reason: "Reason"
})

era group_class_schedules end_schedule GROUP_CLASS_SCHEDULE_ID \
  --ends-on "2026-11-02" \
  --reason "Reason"

{
  "name": "era__group_classes__end_schedule",
  "arguments": {
    "scheduleId": "GROUP_CLASS_SCHEDULE_ID",
    "endsOn": "2026-11-02",
    "reason": "Reason"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 schedule_not_found, schedule_ended, not_found, unknown_reason, ends_in_past, no_workspace · 429 çok sık istek

group_classes.join

Yer ayırt — Yer varken bir müşteriyi dersin bir seansına kaydeder.

Gereken izin group_classes:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/group_classes.join

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.joined

Neye yazar: group_class_joining (insert) — Books the place, with its price frozen

curl -X POST https://app.getera.io/api/v1/group_class_joinings/actions/join \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"scheduleId":"GROUP_CLASS_SCHEDULE_ID","sessionDate":"2026-11-02","customerId":"CUSTOMER_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.joined"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClassJoinings.join({
  scheduleId: "GROUP_CLASS_SCHEDULE_ID",
  sessionDate: "2026-11-02",
  customerId: "CUSTOMER_ID"
})

era group_class_joinings join \
  --schedule-id "GROUP_CLASS_SCHEDULE_ID" \
  --session-date "2026-11-02" \
  --customer-id "CUSTOMER_ID"

{
  "name": "era__group_classes__join",
  "arguments": {
    "scheduleId": "GROUP_CLASS_SCHEDULE_ID",
    "sessionDate": "2026-11-02",
    "customerId": "CUSTOMER_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 schedule_not_found, not_found, class_archived, no_such_session, session_cancelled, inside_cutoff, outside_window, class_full, customer_not_found, customer_banned, already_joined, no_workspace · 429 çok sık istek

group_classes.join_online

Online derse yer ayır — Ziyaretçi, site ders programından yer olan bir ders oturumunda kendine bir yer ayırır.

Gereken izin group_classes:write · veriyi değiştirir · Yayındaki bir siteden de çağrılabilir (visitor)

• Asıl adres: POST /api/v1/actions/group_classes.join_online

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.joined

Neye yazar: group_class_joining (insert) — Books the place, with its price frozen

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 guest_details_required, class_full · 429 çok sık istek

group_classes.mark_attendance

Yoklama al — Geldi ya da gelmedi.

Gereken izin group_classes:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/group_classes.mark_attendance

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.attended, group_classes.no_show

Neye yazar: group_class_joining (update) — Moves it to completed or no_show

curl -X POST https://app.getera.io/api/v1/group_class_joinings/GROUP_CLASS_JOINING_ID/actions/mark_attendance \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"attended":true}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.attended",
    "group_classes.no_show"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClassJoinings.markAttendance("GROUP_CLASS_JOINING_ID", {
  attended: true
})

era group_class_joinings mark_attendance GROUP_CLASS_JOINING_ID \
  --attended true

{
  "name": "era__group_classes__mark_attendance",
  "arguments": {
    "joiningId": "GROUP_CLASS_JOINING_ID",
    "attended": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 joining_not_found, already_cancelled, already_finished, not_yet_started, no_workspace · 429 çok sık istek

group_classes.set_services

Hizmetleri değiştir — Dersi hangi hizmetlerin oluşturduğu — ve dolayısıyla fiyatı.

Gereken izin group_classes:manage · siler ya da geri alınamaz

• Asıl adres: POST /api/v1/actions/group_classes.set_services

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.class_updated

Neye yazar: group_class_service (upsert) — Sets the class’s services; group_class_service (delete) — Removes the ones no longer in it

curl -X POST https://app.getera.io/api/v1/group_class_services/actions/set_services \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"id":"GROUP_CLASS_ID","itemVariantIds":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.class_updated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClassServices.setServices({
  id: "GROUP_CLASS_ID",
  itemVariantIds: {}
})

era group_class_services set_services --data '{"id":"GROUP_CLASS_ID","itemVariantIds":{}}'

{
  "name": "era__group_classes__set_services",
  "arguments": {
    "id": "GROUP_CLASS_ID",
    "itemVariantIds": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, class_archived, no_services, service_not_found, not_a_class_service, service_not_offered_that_day · 429 çok sık istek

group_classes.update_class

Dersi düzenle — Ad, kontenjan ve varsayılan eğitmen.

Gereken izin group_classes:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/group_classes.update_class

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.class_updated

Neye yazar: group_class (update) — Updates the class

curl -X POST https://app.getera.io/api/v1/group_classes/GROUP_CLASSE_ID/actions/update_class \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.class_updated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClasses.updateClass("GROUP_CLASSE_ID", {
  name: "Name"
})

era group_classes update_class GROUP_CLASSE_ID \
  --name "Name"

{
  "name": "era__group_classes__update_class",
  "arguments": {
    "id": "GROUP_CLASSE_ID",
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, class_archived, capacity_below_booked, provider_cannot_perform, no_workspace · 429 çok sık istek

group_classes.update_schedule

Haftalık saati düzenle — Süre ve eğitmen her zaman; gün ve saat yalnızca kimse kayıtlı değilken.

Gereken izin group_classes:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/group_classes.update_schedule

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: group_classes.series_updated

Neye yazar: group_class_schedule (update) — Updates the series

curl -X POST https://app.getera.io/api/v1/group_class_schedules/GROUP_CLASS_SCHEDULE_ID/actions/update_schedule \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"weekday":1}'

{
  "ok": true,
  "result": "…",
  "events": [
    "group_classes.series_updated"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.groupClassSchedules.updateSchedule("GROUP_CLASS_SCHEDULE_ID", {
  weekday: 1
})

era group_class_schedules update_schedule GROUP_CLASS_SCHEDULE_ID \
  --weekday 1

{
  "name": "era__group_classes__update_schedule",
  "arguments": {
    "scheduleId": "GROUP_CLASS_SCHEDULE_ID",
    "weekday": 1
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde group_classes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 schedule_not_found, schedule_ended, class_archived, no_schedule, has_upcoming_joinings, schedule_exists, service_not_offered_that_day, provider_cannot_perform · 429 çok sık istek

Veri modelleri

GroupClassJoining

Tablo group_class_joining · Kaynak group_class_joinings

• GET /api/v1/group_class_joinings
• GET /api/v1/group_class_joinings/{id}

Birincil anahtar: id

Denetimler:

• CHECK ((price_amount >= 0))

GroupClassSchedule

Tablo group_class_schedule · Kaynak group_class_schedules

• GET /api/v1/group_class_schedules
• GET /api/v1/group_class_schedules/{id}

Birincil anahtar: id

Denetimler:

• CHECK (((starts_on IS NULL) OR (ends_on IS NULL) OR (ends_on >= starts_on)))
• CHECK ((duration > 0))
• CHECK (((weekday >= 0) AND (weekday <= 6)))

GroupClassService

Tablo group_class_service · Kaynak group_class_services

• GET /api/v1/group_class_services
• GET /api/v1/group_class_services/{id}

Birincil anahtar: id

Tekil: group_class_id, item_variant_id

GroupClass

Tablo group_class · Kaynak group_classes

• GET /api/v1/group_classes
• GET /api/v1/group_classes/{id}

Birincil anahtar: id

Denetimler:

• CHECK ((capacity > 0))
• CHECK (((length(btrim(name)) >= 1) AND (length(btrim(name)) <= 255)))

Olaylar

İş akışları ve webhook'lar bu olaylara tepki verir.