### GET Make API Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Mevcut araç marka seçeneklerini sunar. ```APIDOC ## GET Make ### Description Lists available vehicle make options. ### Method GET ### Endpoint /Make ### Parameters ### Request Example ``` GET /Make ``` ### Response #### Success Response (200) - **makes** (array) - A list of available vehicle makes. - **id** (string) - The ID for the make. - **name** (string) - The name of the make. #### Response Example ```json { "makes": [ { "id": "0091529", "name": "Toyota" }, { "id": "0091530", "name": "Ford" } ] } ``` ``` -------------------------------- ### GET Usage Style API Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Aracın kullanım amacını belirtmek için kullanılır. Ticari veya bireysel gibi kullanım seçenekleri sunar. ```APIDOC ## GET Usage Style ### Description Provides options for the vehicle's usage style, such as commercial or individual. ### Method GET ### Endpoint /Usage Style ### Parameters ### Request Example ``` GET /Usage Style ``` ### Response #### Success Response (200) - **usageStyles** (array) - A list of available usage style options. - **id** (string) - The ID for the usage style. - **name** (string) - The name of the usage style. #### Response Example ```json { "usageStyles": [ { "id": "1", "name": "Commercial" }, { "id": "2", "name": "Individual" } ] } ``` ``` -------------------------------- ### Get Make and Model APIs Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Allows users to select their vehicle's make and model. The GET Make endpoint lists available car manufacturers, and the GET Model endpoint provides a list of models corresponding to the selected make. This data is essential for identifying the specific vehicle. ```http GET Make ``` ```http GET Model ``` -------------------------------- ### Create Insurance Proposal Request (cURL) Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd An example cURL command to demonstrate how to send a POST request to the 'Teklif - YK Normal' endpoint for creating an insurance proposal. This showcases the necessary headers, URL, and JSON payload structure. ```curl curl --location -g '{{api-gw-uri}}/api/policy/proposal' \ --header 'Content-Type: application/json' \ --data-raw '{ "productId": "101", "insurer": { "idNumber": "41824504930", "email": "mert.guzeler@valde.co", "phoneNumber": "5324542712", "birthDate": "1993-09-23" }, "insureds": [ { "idNumber": "41824504930", "email": "mert.guzeler@valde.co", "phoneNumber": "5324542712", "birthDate": "1993-09-23", "isMain": true } ], "questions": { "packageType": "1", "plateType": "unregistered", "plateCityCode": "34", "usageStyle": "1", "modelYear": "2024", "makeId": "0091529", "engineNumber": "MN13579246801356", "chassisNumber": "SN135792468013579" } }' ``` -------------------------------- ### GET Auto Information API Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Belirli bir kayıtlı araca ait detaylı bilgileri getirir. Araç hakkında kapsamlı bilgiye ve aracın yeni tescil veya yenileme durumu hakkında bilgi sağlar. ```APIDOC ## GET Auto Information ### Description Fetches detailed information for a specific registered vehicle, including its current registration or renewal status. ### Method GET ### Endpoint /Auto Information ### Parameters ### Request Example ``` GET /Auto Information ``` ### Response #### Success Response (200) - **vehicleDetails** (object) - Comprehensive details about the vehicle. - **registrationStatus** (string) - The current registration status of the vehicle. #### Response Example ```json { "vehicleDetails": { "make": "Toyota", "model": "Corolla", "year": 2020, "engineNumber": "ENG12345", "chassisNumber": "CHAS67890" }, "registrationStatus": "Renewed" } ``` ``` -------------------------------- ### Get Usage Style API Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Specifies the vehicle's usage purpose (e.g., commercial or individual). The GET Usage Style endpoint provides a list of available options to ensure correct data input for insurance policy terms. This is important for accurate risk assessment. ```http GET Usage Style ``` -------------------------------- ### GET Model API Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Seçilen araca bağlı olarak model seçeneklerini listeler. ```APIDOC ## GET Model ### Description Lists model options based on the selected vehicle make. ### Method GET ### Endpoint /Model ### Parameters #### Query Parameters - **makeId** (string) - Required - The ID of the vehicle make to filter models by. ### Request Example ``` GET /Model?makeId=0091529 ``` ### Response #### Success Response (200) - **models** (array) - A list of available models for the specified make. - **id** (string) - The ID for the model. - **name** (string) - The name of the model. #### Response Example ```json { "models": [ { "id": "101", "name": "Corolla" }, { "id": "102", "name": "Camry" } ] } ``` ``` -------------------------------- ### GET Year API Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Seçilen aracın model yılını belirler. ```APIDOC ## GET Year ### Description Determines the model year of the selected vehicle. ### Method GET ### Endpoint /Year ### Parameters ### Request Example ``` GET /Year ``` ### Response #### Success Response (200) - **years** (array) - A list of available model years. - **year** (integer) - The model year. #### Response Example ```json { "years": [ { "year": 2020 }, { "year": 2021 }, { "year": 2022 }, { "year": 2023 }, { "year": 2024 } ] } ``` ``` -------------------------------- ### Get Year API Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Determines the model year of the selected vehicle. The GET Year endpoint is used to retrieve the manufacturing year, which is a key factor in determining insurance premiums and vehicle compatibility. ```http GET Year ``` -------------------------------- ### POST Get Access Token Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd API isteklerinde kullanılacak Bearer token döner. Token almanız için gerekli bilgiler size özel olarak sağlanacaktır. M2M için client_credentials grant_type kullanılmalıdır. ```APIDOC ## POST /auth/token ### Description API isteklerinde kullanılacak Bearer token döner. Token almanız için gerekli bilgiler size özel olarak sağlanacaktır. ### Method POST ### Endpoint {{api-gw-uri}}/auth/token ### Parameters #### Query Parameters - **client_id** (string) - Required - Müşteri kimliği. - **client_secret** (string) - Required - Müşteri gizli anahtarı. - **grant_type** (string) - Required - Yetkilendirme türü, M2M için 'client_credentials' kullanılmalıdır. - **scope** (string) - Optional - Opsiyonel olarak scope gönderilerek alınan token kısıtlanabilir. ### Request Example ```json { "client_id": "{{api-gw-client-id}}", "client_secret": "{{api-gw-client-secret}}", "grant_type": "client_credentials" } ``` ### Response #### Success Response (200) Bu istek herhangi bir yanıt gövdesi döndürmez. #### Response Example ```json { "example": "No response body" } ``` ``` -------------------------------- ### Get Auto Information API Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Retrieves detailed information about a registered vehicle. This endpoint provides comprehensive data and indicates the vehicle's registration or renewal status. It's crucial for fetching vehicle specifics before generating an insurance quote. ```http GET Auto Information ``` -------------------------------- ### Get Access Token using cURL Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Retrieves a Bearer token for API authentication. This endpoint requires specific client credentials to be provided. The `grant_type=client_credentials` is used for Machine-to-Machine (M2M) authentication. The `scope` parameter is optional and can be used to restrict the token's permissions. ```cURL curl --location -g '{{api-gw-uri}}/auth/token' \ --data-urlencode 'client_id={{api-gw-client-id}}' \ --data-urlencode 'client_secret={{api-gw-client-secret}}' \ --data-urlencode 'grant_type=client_credentials' ``` -------------------------------- ### Poliçe ve Teklif Yönetimi Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Bu API koleksiyonu, farklı sigorta ürünleri için teklif oluşturma, yenileme ve yönetim işlemlerini kolaylaştırır. Poliçe teminat ve yetkilendirme bilgilerini almanızı sağlar. ```APIDOC ## Poliçe Yönetimi ### Description Bu API koleksiyonu, farklı sigorta ürünlerinin yönetimini sağlamak amacıyla tasarlanmıştır. İçerdiği ürünler ve açıklamaları şu şekildedir: * **Trafik - Plakam Yok** : Kayıtsız araçlara yönelik trafik sigortası için * **Trafik - Plakam Var** : Kayıtlı araçlara yönelik trafik sigortası için * **Kasko - Plakam Yok** : Kayıtsız araçlara yönelik kasko sigortası için * **Kasko - Plakam Var** : Kayıtlı araçlara yönelik kasko sigortası için * **Seyahat Sağlık - Yurt Dışı** : Yurt dışı seyahat sigortası için * **Seyahat Sağlık - Yurt İçi** : Yurt içi seyahat sigortası için * **Seyahat Sağlık - Incoming** : Türkiye'ye gelen yabancı ziyaretçilere özel seyahat sigortası için * **Seyahat Sağlık - Öğrenci** : Öğrencilere özel olarak tasarlanmış seyahat sigortası için * **Dask - Yeni Poliçe** : Zorunlu deprem sigortası (DASK) için yeni poliçe teklifleri için * **Dask - Yenileme** : Zorunlu deprem sigortası (DASK) için yenileme teklifleri için ### Endpoints #### GET Get Policy Coverages ##### Description Belirli bir poliçe için teminat bilgilerini döner. Bu uç nokta, poliçenin hangi teminatları kapsadığını öğrenmek için kullanılır. ##### Method GET ##### Endpoint `/policy/coverages/{policyId}` ##### Parameters ###### Path Parameters - **policyId** (string) - Required - Poliçe kimliği. #### GET Get Policy Authorizations ##### Description Belirli bir poliçeye ait otorizasyonlar bilgilerini getirir. ##### Method GET ##### Endpoint `/policy/authorizations/{policyId}` ##### Parameters ###### Path Parameters - **policyId** (string) - Required - Poliçe kimliği. ``` -------------------------------- ### POST /api/policy/proposal - Teklif - YK Normal Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Trafik sigortası için teklif oluşturur. Gerekli araç ve sigortalı bilgilerini alarak teklif sürecini başlatır. ```APIDOC ## POST /api/policy/proposal ### Description Creates an insurance quote for traffic insurance. Initiates the quoting process by taking necessary vehicle and insured information. ### Method POST ### Endpoint /api/policy/proposal ### Parameters #### Query Parameters (None) #### Request Body - **productId** (string) - Required - The ID of the product for the quote. - **insurer** (object) - Required - Information about the insurer. - **idNumber** (string) - Required - Insurer's ID number. - **email** (string) - Required - Insurer's email address. - **phoneNumber** (string) - Required - Insurer's phone number. - **birthDate** (string) - Required - Insurer's birth date (YYYY-MM-DD). - **insureds** (array) - Required - Information about the insured individuals. - **idNumber** (string) - Required - Insured's ID number. - **email** (string) - Required - Insured's email address. - **phoneNumber** (string) - Required - Insured's phone number. - **birthDate** (string) - Required - Insured's birth date (YYYY-MM-DD). - **isMain** (boolean) - Required - Indicates if this is the main insured person. - **questions** (object) - Required - Details about the vehicle and policy. - **packageType** (string) - Required - The type of package selected. - **plateType** (string) - Required - The type of plate (e.g., "unregistered"). - **plateCityCode** (string) - Required - The city code for the plate (obtainable via `Get Cities`). - **usageStyle** (string) - Required - The usage style of the vehicle (obtainable via `Get Usage Style`). - **modelYear** (integer) - Required - The model year of the vehicle (obtainable via `Get Year`). - **makeId** (string) - Required - The ID of the vehicle make (obtainable via `Get Make`). - **engineNumber** (string) - Required - The engine number of the vehicle. - **plateNumber** (string) - Required - The plate number of the vehicle (fixed for YK). - **chassisNumber** (string) - Required - The chassis number of the vehicle. ### Request Example ```json { "productId": "101", "insurer": { "idNumber": "41824504930", "email": "mert.guzeler@valde.co", "phoneNumber": "5324542712", "birthDate": "1993-09-23" }, "insureds": [ { "idNumber": "41824504930", "email": "mert.guzeler@valde.co", "phoneNumber": "5324542712", "birthDate": "1993-09-23", "isMain": true } ], "questions": { "packageType": "1", "plateType": "unregistered", "plateCityCode": "34", "usageStyle": "1", "modelYear": 2024, "makeId": "0091529", "engineNumber": "MN13579246801356", "plateNumber": "XX", "chassisNumber": "SN135792468013579" } } ``` ### Response #### Success Response (200) (No response body) #### Response Example (None) ``` -------------------------------- ### Trafik Sigortası Entegrasyonu Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Trafik sigortası entegrasyonu, kayıtlı ve kayıtsız araç sahiplerinin sigorta tekliflerini hızlı ve doğru bir şekilde almalarını sağlar. Bu bölüm, trafik sigortası ile ilgili API uç noktalarını ve detaylarını içerir. ```APIDOC ## Trafik Sigortası ### Description Trafik Sigortası entegrasyonu, kayıtlı ve kayıtsız araç sahiplerinin sigorta tekliflerini hızlı ve doğru bir şekilde almalarını sağlar. Sayfa ve API uç noktalarının detaylı açıklamaları şu şekildedir: ### Endpoints * (Burada trafik sigortası ile ilgili spesifik API uç noktaları listelenecektir.) ``` -------------------------------- ### Create Insurance Proposal (POST Teklif - YK Normal) Source: https://documenter.getpostman.com/view/23443005/2sAY4rDPgu/index_auth-info-b8ca840d-e910-4ab7-b31c-a7468e065cdd Creates a new insurance proposal for a vehicle. This endpoint requires detailed information about the vehicle, insurer, and insured individuals. It utilizes TCKN/VKN/YKN for identification and accepts specific codes for plate type, city, usage style, model year, and vehicle make. This is the primary endpoint for generating an insurance quote. ```json { "productId": "101", "insurer": { "idNumber": "41824504930", "email": "mert.guzeler@valde.co", "phoneNumber": "5324542712", "birthDate": "1993-09-23" }, "insureds": [ { "idNumber": "41824504930", "email": "mert.guzeler@valde.co", "phoneNumber": "5324542712", "birthDate": "1993-09-23", "isMain": true } ], "questions": { "packageType": "1", "plateType": "unregistered", "plateCityCode": "34", "usageStyle": "1", "modelYear": "2024", "makeId": "0091529", "engineNumber": "MN13579246801356", "chassisNumber": "SN135792468013579" } } ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.