{ "openapi": "3.1.1", "info": { "title": "EventStage Entegrasyon API'si", "description": "Bir organizasyonun kendi web sitesinin EventStage'deki verilerini okuması için. Her istek, portaldaki API erişimi sayfasından üretilen bir anahtar taşır: `Authorization: Bearer esk_…` ya da `X-Api-Key: esk_…`. Yalnızca okuma yapılır; yayınlanmış etkinlikler, program, onaylı konuşmacılar, sponsorlar ve görünür ekip döner.", "version": "1.0" }, "servers": [ { "url": "https://eventstage.com.tr/" } ], "paths": { "/api/integration/v1/events": { "get": { "tags": [ "IntegrationEvents" ], "summary": "The organization's visible events, one page at a time.", "parameters": [ { "name": "timing", "in": "query", "description": "`upcoming` (the default: not yet started), `ongoing` (running right now),\n`past` (ended, newest first) or `all`.", "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "1-based page number.", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 1 } }, { "name": "pageSize", "in": "query", "description": "Rows per page, at most 100.", "schema": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, { "name": "category", "in": "query", "description": "A category slug (AD-25). Narrows the list to that category; an unknown slug is an empty\npage rather than an error, because a category the platform retired is not the site's fault.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PagedResponseOfIntegrationEventSummaryResponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/integration/v1/events/{idOrSlug}": { "get": { "tags": [ "IntegrationEvents" ], "summary": "One event in full: its details, its programme with speakers, every speaker on it and every sponsor of it.", "parameters": [ { "name": "idOrSlug", "in": "path", "description": "The event's id, or its slug inside this organization.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntegrationEventDetailResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/integration/v1/events/{idOrSlug}/sessions": { "get": { "tags": [ "IntegrationEvents" ], "summary": "The event's programme: scheduled sessions in order, each with its speakers.", "parameters": [ { "name": "idOrSlug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationSessionResponse" } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/integration/v1/events/{idOrSlug}/speakers": { "get": { "tags": [ "IntegrationEvents" ], "summary": "Everyone speaking at the event, once each, in programme order.", "parameters": [ { "name": "idOrSlug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationSpeakerResponse" } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/integration/v1/events/{idOrSlug}/sponsors": { "get": { "tags": [ "IntegrationEvents" ], "summary": "The event's sponsors with their tiers, in the order the organizer arranged them.", "parameters": [ { "name": "idOrSlug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationSponsorResponse" } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/api/integration/v1/organization": { "get": { "tags": [ "IntegrationOrganization" ], "summary": "The organization's public profile: name, description, logo, contact details and address.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntegrationOrganizationResponse" } } } } } } }, "/api/integration/v1/team": { "get": { "tags": [ "IntegrationOrganization" ], "summary": "The team as the organization chose to show it, in display order. Hidden members are left out.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationTeamMemberResponse" } } } } } } } }, "/api/integration/v1/speakers": { "get": { "tags": [ "IntegrationOrganization" ], "summary": "Every speaker who has confirmed at least one scheduled session of a visible event, or a billing\non a visible event (AD-28, §34 T37), once each, by name. People who were only invited are not\nannounced (AD-19), nor is a line-up the platform has not published (AD-18).", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationSpeakerResponse" } } } } } } } }, "/api/integration/v1/sponsors": { "get": { "tags": [ "IntegrationOrganization" ], "summary": "Every sponsor the organization keeps, by name. Tiers belong to events and are null here.", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationSponsorResponse" } } } } } } } } }, "components": { "schemas": { "IntegrationCategoryResponse": { "required": [ "slug", "name" ], "type": "object", "properties": { "slug": { "type": "string", "description": "Stable, and what the `category` filter of `/events` takes." }, "name": { "type": "string", "description": "The Turkish label, for a chip on the site's own card." } }, "description": "The platform category an event is filed under (AD-25)." }, "IntegrationEventDetailResponse": { "required": [ "id", "name", "slug", "description", "cover", "logo", "timing", "start", "end", "venueName", "address", "city", "country", "latitude", "longitude", "isRegistrationOpen", "registrationStart", "registrationEnd", "capacity", "publicUrl", "applicationUrl", "sessions", "speakers", "sponsors" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "slug": { "type": "string" }, "description": { "type": [ "null", "string" ] }, "cover": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationImage" } ] }, "logo": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationImage" } ] }, "timing": { "type": "string" }, "start": { "$ref": "#/components/schemas/IntegrationInstant" }, "end": { "$ref": "#/components/schemas/IntegrationInstant" }, "venueName": { "type": [ "null", "string" ] }, "address": { "type": [ "null", "string" ] }, "city": { "type": [ "null", "string" ] }, "country": { "type": [ "null", "string" ] }, "latitude": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": [ "null", "number", "string" ], "format": "double" }, "longitude": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": [ "null", "number", "string" ], "format": "double" }, "isRegistrationOpen": { "type": "boolean" }, "registrationStart": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationInstant" } ] }, "registrationEnd": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationInstant" } ] }, "capacity": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "publicUrl": { "type": "string" }, "applicationUrl": { "type": "string" }, "sessions": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationSessionResponse" } }, "speakers": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationSpeakerResponse" }, "description": "The distinct speakers across the event's scheduled sessions. A speaker announced before the\nprogramme exists is not here yet, because speakers attach to sessions (§7)." }, "sponsors": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationSponsorResponse" } }, "category": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationCategoryResponse" } ] } }, "description": "An event in full: the programme, everyone speaking at it and everyone sponsoring it, in one\ncall, because that is what an event page on a website needs." }, "IntegrationEventSummaryResponse": { "required": [ "id", "name", "slug", "description", "cover", "logo", "timing", "start", "end", "venueName", "city", "country", "latitude", "longitude", "isRegistrationOpen", "sessionCount", "publicUrl", "applicationUrl" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "slug": { "type": "string" }, "description": { "type": [ "null", "string" ] }, "cover": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationImage" } ] }, "logo": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationImage" } ] }, "timing": { "type": "string", "description": "`upcoming`, `ongoing` or `past`, decided by the clock at the time of the call.\n Never stored (§8), so it is always current." }, "start": { "$ref": "#/components/schemas/IntegrationInstant" }, "end": { "$ref": "#/components/schemas/IntegrationInstant" }, "venueName": { "type": [ "null", "string" ] }, "city": { "type": [ "null", "string" ] }, "country": { "type": [ "null", "string" ] }, "latitude": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": [ "null", "number", "string" ], "format": "double" }, "longitude": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": [ "null", "number", "string" ], "format": "double" }, "isRegistrationOpen": { "type": "boolean" }, "sessionCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "publicUrl": { "type": "string", "description": "The event's own page on EventStage: the programme, the venue, the speakers. Where to send\nsomebody who wants to read about the event rather than apply to it." }, "applicationUrl": { "type": "string", "description": "Where somebody applies to this event: the form EventStage hosts (AD-21), absolute. This is what\na \"Kaydol\" button on the organization's own site points at — the form is never embedded, and\nlinking it needs no API key. Always present, including after registration closes, because the\npage stays reachable and says which reason it is; `isRegistrationOpen` is what decides\nwhether to draw the button." }, "category": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationCategoryResponse" } ] } }, "description": "An event as a list on the organization's website shows it." }, "IntegrationImage": { "required": [ "fileId", "url" ], "type": "object", "properties": { "fileId": { "type": "string", "format": "uuid" }, "url": { "type": "string", "description": "Absolute, on this host, and stable for as long as the image is: replacing an image produces a\nnew id and a new URL, so a page may cache it indefinitely (§25)." } }, "description": "An image an external site can embed directly." }, "IntegrationInstant": { "required": [ "utc", "local", "timeZoneId" ], "type": "object", "properties": { "utc": { "type": "string", "description": "The instant, for anything that computes.", "format": "date-time" }, "local": { "type": "string", "description": "The same instant on the venue's wall clock, with its offset, for anything that prints. A site\ncan render it with no time zone library at all.", "format": "date-time" }, "timeZoneId": { "type": "string", "description": "The IANA zone Local was computed in." } }, "description": "One moment as an organization's own website wants to print it (AD-18)." }, "IntegrationOrganizationResponse": { "required": [ "id", "name", "slug", "description", "logo", "cover", "website", "email", "phone", "address", "city", "country", "latitude", "longitude", "publicUrl" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "slug": { "type": "string" }, "description": { "type": [ "null", "string" ] }, "logo": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationImage" } ] }, "cover": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationImage" } ] }, "website": { "type": [ "null", "string" ] }, "email": { "type": [ "null", "string" ] }, "phone": { "type": [ "null", "string" ] }, "address": { "type": [ "null", "string" ] }, "city": { "type": [ "null", "string" ] }, "country": { "type": [ "null", "string" ] }, "latitude": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": [ "null", "number", "string" ], "format": "double" }, "longitude": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": [ "null", "number", "string" ], "format": "double" }, "publicUrl": { "type": "string", "description": "The organization's page on EventStage, for a \"see all events\" link." } }, "description": "The organization the API key belongs to, as its public profile." }, "IntegrationSessionResponse": { "required": [ "id", "name", "description", "room", "start", "end", "capacity", "speakers", "speakerNames" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "description": { "type": [ "null", "string" ] }, "room": { "type": [ "null", "string" ] }, "start": { "$ref": "#/components/schemas/IntegrationInstant" }, "end": { "$ref": "#/components/schemas/IntegrationInstant" }, "capacity": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "speakers": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationSpeakerResponse" }, "description": "The confirmed speakers on this session, in billing order (AD-19)." }, "speakerNames": { "type": [ "null", "string" ], "description": "The same speakers as one comma-separated line, for a list that has no room for photos. Null\nwhen nobody is confirmed yet." } }, "description": "One session of an event's programme." }, "IntegrationSpeakerResponse": { "required": [ "id", "name", "jobTitle", "company", "bio", "photo", "linkedInUrl", "gitHubUrl", "websiteUrl", "profileUrl" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "jobTitle": { "type": [ "null", "string" ] }, "company": { "type": [ "null", "string" ] }, "bio": { "type": [ "null", "string" ] }, "photo": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationImage" } ] }, "linkedInUrl": { "type": [ "null", "string" ] }, "gitHubUrl": { "type": [ "null", "string" ] }, "websiteUrl": { "type": [ "null", "string" ] }, "profileUrl": { "type": [ "null", "string" ], "description": "This speaker's public EventStage profile (AD-24), absolute, or null. Null is the common case and\nmeans the person has no claimable account, has not accepted the invitation to claim one, has not\nconfirmed their address, or has switched their profile off. A site that links it never has to\ncheck whether the page exists." } }, "description": "A speaker profile, as the organization's programme and website show it." }, "IntegrationSponsorResponse": { "required": [ "id", "name", "description", "logo", "websiteUrl", "tier", "sortOrder", "isOrganizationSponsor" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "description": { "type": [ "null", "string" ] }, "logo": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationImage" } ] }, "websiteUrl": { "type": [ "null", "string" ] }, "tier": { "type": [ "null", "string" ], "description": "The name of the tier this sponsor bought on the event this list belongs to — \"Elmas\",\n\"Altın\" — as the platform catalogue spells it. Null in the organization-wide list, where there\nis no event to have a tier on, and on a link whose tier the organizer never set. Shipped before\nthe catalogue existed and therefore kept as the printable name; a few old links still carry the\nfree text an organizer typed then, and it arrives here unchanged (AD-18)." }, "sortOrder": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "description": "Position on the event; zero in the organization-wide list.", "format": "int32" }, "isOrganizationSponsor": { "type": "boolean", "description": "Whether the company backs the organization as a whole, not only particular events — the\nsponsors a community lists on its home page (AD-19)." }, "tierId": { "type": [ "null", "string" ], "description": "The catalogue tier's identifier, for a site that wants to group by tier without matching on\nnames. Null whenever Tier is free text or absent.", "format": "uuid" }, "tierRank": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "description": "Where the tier sits in the catalogue: lower is more prestigious, so Diamond sorts above Gold.\nNull under the same conditions as TierId. This, not\nSortOrder, is what groups a sponsor wall into bands.", "format": "int32" }, "tierBadge": { "oneOf": [ { "type": "null" }, { "description": "The tier's badge artwork, absolute, when the platform gave it one.", "$ref": "#/components/schemas/IntegrationImage" } ] } }, "description": "A sponsor, either from the organization's pool or on one event." }, "IntegrationTeamMemberResponse": { "required": [ "id", "fullName", "title", "bio", "photo", "linkedInUrl", "websiteUrl", "sortOrder", "role" ], "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "fullName": { "type": "string" }, "title": { "type": [ "null", "string" ] }, "bio": { "type": [ "null", "string" ] }, "photo": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/IntegrationImage" } ] }, "linkedInUrl": { "type": [ "null", "string" ] }, "websiteUrl": { "type": [ "null", "string" ] }, "sortOrder": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "role": { "type": "string", "description": "`Owner` or `Member` (§35 T61): an organization's website lists its owners as the\n community's managers — every one of them, not only the person who founded it." } }, "description": "A person on the organization's public team page (AD-18). Never a login." }, "PagedResponseOfIntegrationEventSummaryResponse": { "required": [ "items", "page", "pageSize", "totalCount" ], "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/IntegrationEventSummaryResponse" } }, "page": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "pageSize": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "totalCount": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "hasMore": { "type": "boolean", "description": "Whether asking for the next page could return anything." } }, "description": "One page of a list endpoint (§12)." }, "ProblemDetails": { "type": "object", "properties": { "type": { "type": [ "null", "string" ] }, "title": { "type": [ "null", "string" ] }, "status": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "detail": { "type": [ "null", "string" ] }, "instance": { "type": [ "null", "string" ] } } } }, "securitySchemes": { "ApiKey": { "type": "http", "description": "Organizasyonun API anahtarı. X-Api-Key başlığıyla da gönderilebilir.", "scheme": "bearer" } } }, "security": [ { "ApiKey": [ ] } ], "tags": [ { "name": "IntegrationEvents" }, { "name": "IntegrationOrganization" } ] }