etkinlik / etkinlik-io-api
API for integrating with event content aggregated and categorized from many sources and organizers. Use this documentation to build applications on top of Etkinlik.io event data.
Requires
- php: ^8.2
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- guzzlehttp/guzzle: ^7.3
- guzzlehttp/psr7: ^1.7 || ^2.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.5
- phpunit/phpunit: ^8.0 || ^9.0
This package is not auto-updated.
Last update: 2026-06-03 18:26:00 UTC
README
API for integrating with event content aggregated and categorized from many sources and organizers. Use this documentation to build applications on top of Etkinlik.io event data.
For more information, please visit https://etkinlik.io/api-bilgi.
Installation & Usage
Requirements
PHP 8.1 and later.
Composer
To install the bindings via Composer, add the following to composer.json:
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/etkinlik/php-sdk.git"
}
],
"require": {
"etkinlik/etkinlik-io-api": "*@dev"
}
}
Then run composer install
Manual Installation
Download the files and include autoload.php:
<?php require_once('/path/to/EtkinlikIoApi/vendor/autoload.php');
Getting Started
Please follow the installation procedure and then run the following:
<?php require_once(__DIR__ . '/vendor/autoload.php'); // Configure API key authorization: apiKey $config = EtkinlikIo\Api\Configuration::getDefaultConfiguration()->setApiKey('X-Etkinlik-Token', 'YOUR_API_KEY'); // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed // $config = EtkinlikIo\Api\Configuration::getDefaultConfiguration()->setApiKeyPrefix('X-Etkinlik-Token', 'Bearer'); $apiInstance = new EtkinlikIo\Api\Api\CategoriesApi( // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`. // This is optional, `GuzzleHttp\Client` will be used as default. new GuzzleHttp\Client(), $config ); try { $result = $apiInstance->listCategories(); print_r($result); } catch (Exception $e) { echo 'Exception when calling CategoriesApi->listCategories: ', $e->getMessage(), PHP_EOL; }
API Endpoints
All URIs are relative to https://etkinlik.io/api/v2
| Class | Method | HTTP request | Description |
|---|---|---|---|
| CategoriesApi | listCategories | GET /categories | List categories |
| CitiesApi | listCities | GET /cities | List cities |
| DistrictsApi | listCityDistricts | GET /cities/{id}/districts | List districts by city |
| EventsApi | getEvent | GET /events/{id} | Event detail |
| EventsApi | listEvents | GET /events | List events |
| EventsApi | recordEventImpression | POST /events/{id}/impressions | Record event impression |
| FormatsApi | listFormats | GET /formats | List formats |
| NeighborhoodsApi | listDistrictNeighborhoods | GET /districts/{id}/neighborhoods | List neighborhoods by district |
| VenuesApi | getVenue | GET /venues/{id} | Venue detail |
| VenuesApi | listVenues | GET /venues | List venues |
Models
- ApiAuthorizationError
- ApiDeletedError
- ApiDuplicateRecordError
- ApiGeneralError
- ApiNotFoundError
- Category
- City
- District
- Event
- EventImpressionCreated
- EventImpressionRequest
- EventVenueData
- Format
- Neighborhood
- PaginatedEvents
- PaginatedVenues
- PaginationMeta
- Tag
- Venue
- VenueManual
Authorization
Authentication schemes defined for the API:
apiKey
- Type: API key
- API key parameter name: X-Etkinlik-Token
- Location: HTTP header
Tests
To run the tests, use:
composer install vendor/bin/phpunit
Author
About this package
This PHP package is automatically generated by the OpenAPI Generator project:
- API version:
2.0.5- Generator version:
7.22.0
- Generator version:
- Build package:
org.openapitools.codegen.languages.PhpClientCodegen