### Getting Started with Avito API Source: https://developers.avito.ru/about-api Guides for integrating with the Avito API, whether using existing solutions or developing custom applications. It details the requirements for obtaining API keys. ```APIDOC AvitoAPI: GettingStarted: - For Existing Integrations: Refer to the [list of solutions](https://www.avito.ru/business/integrations). Requires personal keys available for users with a specific tariff. - For Custom Applications (Internal Use): Requires [personal authorization keys](https://www.avito.ru/professionals/api). Allows for custom integrations with Avito API methods. - For Custom Applications (External Use): Submit a request via [this form](https://developers.avito.ru/applications). Response within 1-2 business days. Instructions are provided. ``` -------------------------------- ### Request Payload Example Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Example JSON payload for a delivery request, detailing tariff information, directions, zones, and service calculations. ```json { "deliveryProviderTariffId": "FAST_FROM_2020-02-10", "directions": [ { "providerDirectionId": "12-34", "tagFrom": "moscow", "tagTo": "kazan", "zones": [ { "tariffZoneId": "t42", "termsZoneId": "z42", "type": "0" } ] } ], "name": "Быстрый от 2020-02-10", "tariffZones": [ { "deliveryProviderZoneId": "t42", "items": [ { "calculationMechanic": "GAP_TO_COST", "chargeableParameter": "WEIGHT", "serviceName": "DELIVERY", "values": [ { "cost": 50000, "maxWeight": 3000 }, { "cost": 60000, "maxWeight": 7000 }, { "cost": 70000, "maxWeight": 10000 }, { "cost": 90000, "maxWeight": 20000 } ] }, { "calculationMechanic": "GAP_TO_PERCENT", "chargeableParameter": "DECLARED_COST", "serviceName": "INSURANCE", "values": [ { "maxDeclaredCost": 10000, "percent": 1 }, { "maxDeclaredCost": 1000000, "percent": 1.5 } ] }, { "calculationMechanic": "GAP_TO_COST", "chargeableParameter": "PAID_WEIGHT", "serviceName": "DELIVERY_B2C", "values": [ { "cost": 45000, "dimensionalFactor": 5000, "maxWeight": 3000 }, { "cost": 55000, "dimensionalFactor": 5000, "maxWeight": 7000 }, { "cost": 65000, "dimensionalFactor": 5000, "maxWeight": 10000 }, { "cost": 85000, "dimensionalFactor": 5000, "maxWeight": 20000 } ] }, { "calculationMechanic": "GAP_TO_PERCENT", "chargeableParameter": "DECLARED_COST", "serviceName": "INSURANCE_B2C", "values": [ { "maxDeclaredCost": 10000, "percent": 1.5 }, { "maxDeclaredCost": 1000000, "percent": 2 } ] } ], "name": "Тарифная зона t42" } ], "termsZones": [ { "deliveryProviderZoneId": "z42", "maxTerm": 2, "minTerm": 1, "name": "зона z42" } ] } ``` -------------------------------- ### Request Payload Example Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation This JSON payload demonstrates a typical request for listing an item on Avito, including barcodes, item details, and user options. ```json { "barcodes": [ "1000001389165", "80511176616217" ], "items": [ { "breadcrumbs": [ { "name": "Спорт и отдых" } ], "cost": 1000, "description": "В наличии 🔥 Подшипники для самокатов и роликов Abec 7\n\nСервис-магазин RollersLife на Савушкина 141(Тк Меркурий)\n\n▬▬▬▬▬▬▬▬▬\n\nОписание товара:\n\n♦ Подшипники для роликовых коньков и самокатов. цена указана за 1 штуку. 608 2rs Abec: 7 Пыльник: Пластик- полиуретановый Тип подшипника: закрытый Размеры: d 8 / D 22 / B 7 Комплект подшипников для роликовых коньков 16 штук 1000 рублей\n\n♦ Запчасть можно купить в нашей мастерской, при необходимости есть услуга по ремонту.\n\n▬▬▬▬▬▬▬▬▬\n\n❗️ В наличии большой ассортимент самокатов и запчастей ❗️\n\n💰 Оплата любым удобным способом 💳\n\nЗВОНИТЕ/ПИШИТЕ ПРЯМО СЕЙЧАС\n\n▬▬▬▬▬▬▬▬▬\n\n🔧 Ремонтируем\n\n✅ Электро-самокаты, гироскутеры, самокаты детские и взрослые,\n\n✅ Роликовые коньки, скейтборды, беговелы, велосипеды,\n\n✅ Детские коляски, чемоданы, тележки,\n\n✅ Горные лыжи, сноуборды.\n\n⚙️ Электросамокаты Kugoo, Xiaomi, Ninebot, Jack Hot, Hoverbot.\n\n⚙️ Гироскутеры всех брендов Smart Balance, Hoverbot и другие.\n\n▬▬▬▬▬▬▬▬▬\n\n👉 Осуществляем доставку курьером по Санкт-Петербургу\n", "dimensions": { "accuracy": "APPROXIMATE", "values": [ 20, 20, 20 ] }, "id": 2574253956, "imagesUrls": { "list": [ "//24.img.avito.st/image/1/1.pUbrSba6Ca_d4MuqrTPvNzbqD6tfagFtWuoNp1_iCw.kszrqWjK0pNKI4ayaT821U-Ln2lzT8lSuqNt7pqedno", "//19.img.avito.st/image/1/1.rlbjCLa6Ar_VocC6s3LkJz6rBLtXKwp9UqsGt1ejAA.C4io31wn3Rjlc7SJGgeIVyxzC9LnoQUkGwmyaQ67-qs", "//90.img.avito.st/image/1/1.Z0Dh2ba6y6nXcAmso6AtMTx6za1V-sNrUHrPoVVyyQ.T1yZ87ZDiUSrUQNTYJkDbXub3lHC9_XBFtc8D1jOt7c", "//76.img.avito.st/image/1/1.QTUceba67dwq0C_ZEngLRMHa69ioWuUerdrp1KjS7w.JABYB8SsN5W6u5Y6WR49R8kKzr5IsGxF5HTjQPnygYQ", "//85.img.avito.st/image/1/1.eITjzra61G3VZxZon88y9T5t0mlX7dyvUm3QZVdl1g.aQyF5iZccldCZ5p9qtb-DZZobnPzdCSanQJmdHXQvdc" ], "listing": "//24.img.avito.st/image/1/1.pUbrSba6Ca_d4MuqrTPvNzbqD6tfagFtWuoNp1_iCw.kszrqWjK0pNKI4ayaT821U-Ln2lzT8lSuqNt7pqedno" }, "quantity": 1, "tags": "TRY_ON", "title": "Подшипники для самокатов и роликов Abec 7", "weight": { "accuracy": "APPROXIMATE", "value": 1 } } ], "options": { "return": { "receiver": { "delivery": { "completenessAndIntegrity": [ "DIRECT_FLOW", "RETURN_FLOW" ], "courier": { "address": { "addressRow": "Москва, ул. Лесная, 20с2", "coordinates": { "latitude": 55.779003, "longitude": 37.591746 }, "details": { "flat": "23", "floor": "4", "house": "20с2", "porch": "2" } }, "dateTimeInterval": { "end": "2025-02-01T10:26:15+03:00", "start": "2025-02-01T10:26:15+03:00" }, "options": { "comment": "Комментарий для курьера", "deliveryConfirmationType": "PHONE", "deliveryType": "DELIVERY_TO_DOOR", "elevatorAvailable": true }, "provider": "pecom-t2d" }, "secondPartyLogist": { "provider": "string" }, "sortingCenter": { "accuracy": "APPROXIMATE", "id": "123", "provider": "exmail" }, "terminal": { "accuracy": "APPROXIMATE", "id": "123", "provider": "exmail" }, "type": "TERMINAL" }, "email": "any_email@mail.com", "inn": "7727563778", "name": "Иванов Иван Иванович", "phones": [ "88005553535", "79999999999", "+79859991234" ], "type": "PRIVATE" }, "refused": { "action": "DESTROY", "after": { "unit": "DAY", "value": 14 } }, "returned": { "action": "DESTROY", "after": { "unit": "DAY", "value": 14 } }, "unclaimed": { "action": "DESTROY", "after": { "unit": "DAY", "value": 14 } } }, "tags": "C2C" } } ``` -------------------------------- ### Request Payload Example Source: https://developers.avito.ru/api-catalog/job/documentation Example JSON payload for creating or updating a job posting. It includes details such as address, age preferences, contact information, experience, and billing type. ```json { "address": "Москва", "age_preferences": [ "olderThan45", "withHealthProblems" ], "allow_messages": true, "apply_processing": { "apply_type": "only_with_resume" }, "billing_type": "package", "contacts": { "name": "менеджер", "phone": { "city": "201", "country": "+7", "number": "1001158" } }, "description": "описание", "experience": { "id": "moreThan1" }, "is_remote": false, "is_side_job": true, "name": "объявление", "payout_frequency": { "id": "dailyPay" }, "profession": 3201667 } ``` -------------------------------- ### Request Payload Example Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Example JSON payload for uploading terminals, specifying custom schedules, provider area numbers, services, and use of all areas. ```json [ { "customSchedule": [ { "date": "2006-01-04", "intervals": [ "09:00:00/12:00:00" ] } ], "providerAreaNumber": [ "7989jgftyf-jkghtd" ], "services": [ "intake" ], "useAllAreas": true } ] ``` -------------------------------- ### Vacancy Response Sample Source: https://developers.avito.ru/api-catalog/job/documentation Example JSON response for a successful vacancy retrieval, containing the vacancy ID. ```JSON { "id": "string" } ``` -------------------------------- ### Sample Vacancy JSON Source: https://developers.avito.ru/api-catalog/job/documentation An example JSON payload representing a job vacancy, including details about address, description, activity status, parameters, salary, and timestamps. ```JSON { "addressDetails": { "address": "Санкт-Петербург, Пушкин, Малая улица, 12", "city": "Пушкин", "coordinates": { "latitude": 55.778644, "longitude": 37.587901 }, "province": "Санкт-Петербург" }, "description": "Удобное расположение в разных районах Санкт-Петербурга.\nОпыт не обязателен.Обучение.\nГрафик:2/2 5/2 3/3 (День,ночь)", "id": 2142059193, "is_active": true, "params": { "address": "Санкт-Петербург, Пушкин, Малая улица, 12", "age_preferences": [ "Соискатели старше 45 лет" ], "bonuses": [ "Униформа" ], "business_area": "string", "change": [ "1 / 2" ], "construction_work_type": [ "Малярные работы" ], "coordinates": { "latitude": 55.778644, "longitude": 37.587901 }, "cuisine": [ "Русская" ], "delivery_method": [ "На автомобиле" ], "driving_experience": "Нет опыта", "driving_license_category": [ "A" ], "eatery_type": [ "Кафе" ], "experience": "Без опыта", "facility_type": [ "Производство" ], "food_production_shop_type": [ "Холодный" ], "is_company_car": "Да", "medical_book": "Должен оформить кандидат", "paid_period": "в месяц", "payout_frequency": "почасовая оплата", "piecework_flag": "Сдельная оплата", "profession": "string", "programs": [ "Частые выплаты" ], "registration_method": [ "Трудовой договор" ], "retail_equipment_type": [ "Касса и POS-терминалы" ], "retail_shop_type": [ "Гипермаркет или супермаркет" ], "salary": { "from": 30000, "to": 60000 }, "salary_base_bonus": "5% от продаж в месяц", "salary_base_range": { "from": 30000, "to": 60000 }, "schedule": "5/2", "taxes": "До вычета налогов", "tools_availability": "Нужны свои", "where_to_work": "На дому", "worker_class": [ "1" ] }, "salary": 30000, "start_time": "2020-08-21T08:37:36Z", "title": "Фасовщики, Упаковщики, Комплектовщики", "update_time": "2020-08-21T09:39:25Z", "url": "/moskva/vakansii/fasovschiki_upakovschiki_komplektovschiki_469099_2142059193", "uuid": "b6f76fd2-bb67-11ef-9558-87673267655c" } ``` -------------------------------- ### Get Application IDs Source: https://developers.avito.ru/api-catalog/job/documentation Retrieves a list of application IDs based on specified query parameters. Supports filtering by update date, cursor for pagination, vacancy IDs, and viewed status. Includes example requests for fetching the first page and subsequent pages. ```APIDOC GET /job/v1/applications/get_ids https://api.avito.ru/job/v1/applications/get_ids Query Parameters: - updatedAtFrom (string, required): Format YYYY-MM-DD. Filters applications updated from this date. - cursor (string, optional): Identifier of the last application from the previous request for pagination. - vacancyIds (string, optional): Comma-separated vacancy IDs for filtering. - is_viewed (boolean, optional): Filters applications by viewed status. Header Parameters: - X-Is-Employee (boolean, optional): Allows fetching applications for vacancies posted by the employee. - Authorization (string, required): Bearer ACCESS_TOKEN for authentication. Responses: - 200: Successful response. - 429: Too many requests. Response Sample (200): { "applies": [ { "created_at": "2022-03-21T10:23:23Z", "id": "11102026de0ad1be10e2236f", "updated_at": "2022-03-21T12:37:41Z" } ] } ``` -------------------------------- ### Avito SBC Gateway API Documentation Source: https://developers.avito.ru/api-catalog/sbc-gateway/documentation Documentation for the Avito SBC Gateway API, which allows sending discount and special offer mailings through the messenger. It covers creating mailings, confirming and paying for them, checking service availability for listings, retrieving tariff information, and getting statistics. ```APIDOC APIDOC: Avito SBC Gateway API ## Общая информация С помощью методов API из этого раздела вы можете отправлять через мессенджер рассылки скидок и спецпредложений покупателям, которые добавили ваши объявления в избранное, получать информацию о доступных для применения услуги объявлениях, информацию об остатке количества рассылок в тарифе (если тариф подключен). ## Список методов: * **openApiMultiCreate**: Создать рассылку. * URL: /api/v1/sbc-gateway/multi * Method: POST * Description: Allows creating a discount or special offer mailing. * Parameters: (Details not provided in the input) * Returns: (Details not provided in the input) * **openApiMultiConfirm**: Подтвердить и оплатить рассылку. * URL: /api/v1/sbc-gateway/multi/confirm * Method: POST * Description: Confirms and pays for a previously created mailing. * Parameters: (Details not provided in the input) * Returns: (Details not provided in the input) * **openApiAvailable**: Проверить доступность услуги по каждому из переданных объявлений. * URL: /api/v1/sbc-gateway/available * Method: POST * Description: Checks the availability of the service for each of the provided listings. * Parameters: (Details not provided in the input) * Returns: (Details not provided in the input) * **openApiTariffInfo**: Получить информацию по тарифу. * URL: /api/v1/sbc-gateway/tariff * Method: GET * Description: Retrieves information about the current tariff, including remaining mailings. * Parameters: (Details not provided in the input) * Returns: (Details not provided in the input) * **openApiStats**: Получить статистику по заданному периоду. * URL: /api/v1/sbc-gateway/stats * Method: GET * Description: Retrieves statistics for a specified period. * Parameters: (Details not provided in the input) * Returns: (Details not provided in the input) [Скачать swagger](blob:https://developers.avito.ru/32a9cafa-7fca-4b1b-81f0-efbaa55e974d) ``` -------------------------------- ### Avito Job API - Login and Posting a Vacancy Source: https://developers.avito.ru/api-catalog/job/documentation Provides links and instructions for user login/registration and for posting a new job advertisement on Avito. It highlights the process of authentication and initiating the ad placement. ```APIDOC Avito Job API Actions: - Login and Registration: https://developers.avito.ru/api-catalog/job/documentation#login?authsrc=h - Post a Vacancy: https://developers.avito.ru/api-catalog/job/documentation#login?next=https%3A%2F%2Fwww.avito.ru%2Fadditem&authsrc=ca ``` -------------------------------- ### Response Payload Example Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Example JSON response payload for a delivery request, indicating success with a task ID or an error message. ```json { "data": { "taskId": 0 }, "error": { "code": "fail", "message": "something went wrong" } } ``` -------------------------------- ### Avito Authorization API Source: https://developers.avito.ru/api-catalog/auth/documentation Provides methods to access Avito APIs for integration setup. Includes general information, technical documentation, and a link to download the Swagger specification. ```APIDOC Authorization API: - Swagger Download: blob:https://developers.avito.ru/34f8ac40-4e49-49cd-9a3c-76a855157261 - General Information: - Description: https://developers.avito.ru/api-catalog/auth/documentation#ApiDescriptionBlock - Overview: https://developers.avito.ru/api-catalog/auth/documentation#info/obshchaya_informaciya - Method List: https://developers.avito.ru/api-catalog/auth/documentation#info/spisok_metodov - Technical Documentation: https://developers.avito.ru/api-catalog/auth/documentation#ApiDocumentationBlock - Login: https://developers.avito.ru/api-catalog/auth/documentation#login?authsrc=h ``` -------------------------------- ### Basket Parcel Creation Example Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Provides an example of a request payload for creating a parcel that contains multiple items, illustrating the 'basket' functionality. ```json { "parcel": { "items": [ { "sku": "item1_sku", "count": 1 }, { "sku": "item2_sku", "count": 2 } ] } } ``` -------------------------------- ### Response Payload Example Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Example JSON response for terminal upload operations, indicating success with a task ID or failure with an error code and message. ```json { "data": { "taskId": 0 }, "error": { "code": "fail", "message": "something went wrong" } } ``` -------------------------------- ### CPX Promo API Documentation Source: https://developers.avito.ru/api-catalog/cpxpromo/documentation API for setting target action prices, budgets, and spending limits to promote one or more listings. Enables two-way integration between Avito and third-party systems. ```APIDOC Authentication: - Details on how to authenticate with the CPX Promo API. CPX Promo API Methods: getGetDetailedInformationAboutActiveAndAvailableRatesAndBudgets(): Retrieves detailed information about active and available rates and budgets. postGetCurrentViewRatesAndBudgetsForMultipleListings(listingIds: list): Retrieves current view rates and budgets for multiple listings. Parameters: listingIds: A list of listing IDs. postStopPromotion(listingId: str): Stops the promotion for a specific listing. Parameters: listingId: The ID of the listing to stop promotion for. postSetupAutomaticPromotion(listingId: str, targetActionPrice: float, budget: float, dailyLimit: float): Sets up automatic promotion for a listing. Parameters: listingId: The ID of the listing. targetActionPrice: The desired price for a target action. budget: The total budget for the promotion. dailyLimit: The daily spending limit. postSetManualPromotionRate(listingId: str, manualRate: float): Sets a manual promotion rate for a listing. Parameters: listingId: The ID of the listing. manualRate: The manual rate to set. ``` -------------------------------- ### Avito API Catalog Overview Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Provides general information about the Avito API and its catalog. Links to 'About API' and 'API Catalog' sections. ```APIDOC About API: https://developers.avito.ru/about-api API Catalog: https://developers.avito.ru/api-catalog ``` -------------------------------- ### Error Response Example Source: https://developers.avito.ru/api-catalog/job/documentation Example JSON response indicating an error, typically a bad request or invalid data. It specifies the reason, type, and the problematic value. ```json { "error": { "reason": "is_empty", "type": "bad_json_data", "value": "billing_type" } } ``` -------------------------------- ### Avito Job Vacancy Response Sample Source: https://developers.avito.ru/api-catalog/job/documentation Example JSON response for a job vacancy listing on Avito, including address details, description, salary, and other relevant parameters. ```json [ { "addressDetails": { "address": "Санкт-Петербург, Пушкин, Малая улица, 12", "city": "Пушкин", "coordinates": { "latitude": 55.778644, "longitude": 37.587901 }, "province": "Санкт-Петербург" }, "description": "Удобное расположение в разных районах Санкт-Петербурга.\nОпыт не обязателен.Обучение.\nГрафик:2/2 5/2 3/3 (День,ночь)", "id": 2142059193, "is_active": true, "params": { "address": "Санкт-Петербург, Пушкин, Малая улица, 12", "age_preferences": [ "Соискатели старше 45 лет" ], "bonuses": [ "Униформа" ], "business_area": "string", "change": [ "1 / 2" ], "construction_work_type": [ "Малярные работы" ], "coordinates": { "latitude": 55.778644, "longitude": 37.587901 }, "cuisine": [ "Русская" ], "delivery_method": [ "На автомобиле" ], "driving_experience": "Нет опыта", "driving_license_category": [ "A" ], "eatery_type": [ "Кафе" ], "experience": "Без опыта", "facility_type": [ "Производство" ], "food_production_shop_type": [ "Холодный" ], "is_company_car": "Да", "medical_book": "Должен оформить кандидат", "paid_period": "в месяц", "payout_frequency": "почасовая оплата", "piecework_flag": "Сдельная оплата", "profession": "string", "programs": [ "Частые выплаты" ], "registration_method": [ "Трудовой договор" ], "retail_equipment_type": [ "Касса и POS-терминалы" ], "retail_shop_type": [ "Гипермаркет или супермаркет" ], "salary": { "from": 30000, "to": 60000 }, "salary_base_bonus": "5% от продаж в месяц", "salary_base_range": { "from": 30000, "to": 60000 }, "schedule": "5/2", "taxes": "До вычета налогов", "tools_availability": "Нужны свои", "where_to_work": "На дому", "worker_class": [ "1" ] }, "salary": 30000, "start_time": "2020-08-21T08:37:36Z", "title": "Фасовщики, Упаковщики, Комплектовщики", "update_time": "2020-08-21T09:39:25Z", "url": "/moskva/vakansii/fasovschiki_upakovschiki_komplektovschiki_469099_2142059193", "uuid": "b6f76fd2-bb67-11ef-9558-87673267655c" } ] ``` -------------------------------- ### Avito Delivery Sandbox API Response Sample for Task Information Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Example JSON response for retrieving information about a task. It details the task's state, results, and any associated errors. ```JSON { "data": { "errors": [ { "code": "fail", "message": "something went wrong" } ], "result": { "edited": "string", "incoming": "string" }, "state": "string", "taskId": 0 }, "error": { "code": "fail", "message": "something went wrong" } } ``` -------------------------------- ### Get Preview by ID Source: https://developers.avito.ru/api-catalog/autoteka/documentation Retrieves the current status of a preview report and brief information about the requested VIN. This endpoint is used to get the results after initiating a preview request. ```APIDOC ## Получение превью по его ID Возвращает текущий статус сбора информации превью, и краткую инфо по запрашиваемому `VIN` ``` -------------------------------- ### Avito Delivery Sandbox API Response Sample for Task Creation Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Example JSON response received after creating a task in the Avito Delivery Sandbox. It includes a task ID for tracking and potential error details. ```JSON { "data": { "taskId": 0 }, "error": { "code": "fail", "message": "something went wrong" } } ``` -------------------------------- ### Avito API Catalog Overview Source: https://developers.avito.ru/api-catalog/autoload/documentation Links to various API documentation sections within the Avito developer portal. ```APIDOC API Catalog: About API: https://developers.avito.ru/about-api API Catalog: https://developers.avito.ru/api-catalog Accounts Hierarchy: https://developers.avito.ru/api-catalog/accounts-hierarchy/documentation Auction: https://developers.avito.ru/api-catalog/auction/documentation Auth: https://developers.avito.ru/api-catalog/auth/documentation Autoload: https://developers.avito.ru/api-catalog/autoload/documentation Autostrategy: https://developers.avito.ru/api-catalog/autostrategy/documentation Autoteka: https://developers.avito.ru/api-catalog/autoteka/documentation CallTracking[KT]: https://developers.avito.ru/api-catalog/calltracking/documentation CPA Avito: https://developers.avito.ru/api-catalog/cpa/documentation CPXPromo (Target action price setting): https://developers.avito.ru/api-catalog/cpxpromo/documentation Delivery Sandbox: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Item: https://developers.avito.ru/api-catalog/item/documentation Job (Avito.Work): https://developers.avito.ru/api-catalog/job/documentation Messenger: https://developers.avito.ru/api-catalog/messenger/documentation Order Management: https://developers.avito.ru/api-catalog/order-management/documentation Ratings and Reviews: https://developers.avito.ru/api-catalog/ratings/documentation SBC Gateway (Discount and special offer mailing in messenger (beta-version)): https://developers.avito.ru/api-catalog/sbc-gateway/documentation Stock Management: https://developers.avito.ru/api-catalog/stock-management/documentation Short-term Rent: https://developers.avito.ru/api-catalog/str/documentation Tariffs: https://developers.avito.ru/api-catalog/tariff/documentation TrxPromo: https://developers.avito.ru/api-catalog/trxpromo/documentation User Information: https://developers.avito.ru/api-catalog/user/documentation ``` -------------------------------- ### Job Posting API: Get Vacancies Endpoint Source: https://developers.avito.ru/api-catalog/job/documentation A new GET request, `job/v2/vacancies`, has been added to retrieve a list of vacancies. Detailed information for this new request is available in the technical documentation. ```APIDOC GET /job/v2/vacancies Retrieves a list of vacancies. Refer to the technical documentation for detailed information. ``` -------------------------------- ### Avito API Catalog Overview Source: https://developers.avito.ru/api-catalog/auth/documentation Provides an overview of the Avito API catalog, including links to general information, API updates, and specific API documentation sections like Authorization, Accounts Hierarchy, Auction, and more. ```APIDOC API Catalog: - About API: https://developers.avito.ru/about-api - API Catalog: https://developers.avito.ru/api-catalog - API Updates: https://developers.avito.ru/api-updates Specific APIs: - Accounts Hierarchy: https://developers.avito.ru/api-catalog/accounts-hierarchy/documentation - Auction: https://developers.avito.ru/api-catalog/auction/documentation - Authorization: https://developers.avito.ru/api-catalog/auth/documentation - Autoload: https://developers.avito.ru/api-catalog/autoload/documentation - Autostrategy: https://developers.avito.ru/api-catalog/autostrategy/documentation - Autoteka: https://developers.avito.ru/api-catalog/autoteka/documentation - CallTracking: https://developers.avito.ru/api-catalog/calltracking/documentation - CPA Avito: https://developers.avito.ru/api-catalog/cpa/documentation - CPXPromo: https://developers.avito.ru/api-catalog/cpxpromo/documentation - Delivery: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation - Items: https://developers.avito.ru/api-catalog/item/documentation - Job: https://developers.avito.ru/api-catalog/job/documentation - Messenger: https://developers.avito.ru/api-catalog/messenger/documentation - Order Management: https://developers.avito.ru/api-catalog/order-management/documentation - Ratings and Reviews: https://developers.avito.ru/api-catalog/ratings/documentation - SBC Gateway: https://developers.avito.ru/api-catalog/sbc-gateway/documentation - Stock Management: https://developers.avito.ru/api-catalog/stock-management/documentation - Short-term Rent: https://developers.avito.ru/api-catalog/str/documentation - Tariffs: https://developers.avito.ru/api-catalog/tariff/documentation - TrxPromo: https://developers.avito.ru/api-catalog/trxpromo/documentation - User: https://developers.avito.ru/api-catalog/user/documentation ``` -------------------------------- ### Get Vacancy API Endpoint Source: https://developers.avito.ru/api-catalog/job/documentation Details for the GET endpoint to retrieve job vacancy data. Includes path parameters, query parameters for fields and additional data, and authorization requirements. ```APIDOC GET /job/v2/vacancies/{vacancy_id} URL: https://api.avito.ru/job/v2/vacancies/{vacancy_id} Description: Retrieves job vacancy data. By default, all fields and parameters are returned. If only a subset of fields is specified, other fields will be absent. To view data, you must be the owner of the vacancy. Authorizations: - job:vacancy (AuthorizationCode, ClientCredentials) Path Parameters: - vacancy_id (required, integer ): Идентификатор вакансии Query Parameters: - fields (string, Enum: "title", "description", "url", "salary", "start_time", "update_time", "is_active", Example: fields=title,description,salary): Поля основного тела ответа (можно указать несколько значений через запятую). По умолчанию отображаются все поля. - params (string, Enum: "business_area", "schedule", "experience", "address", "coordinates", "change", "where_to_work", "payout_frequency", "age_preferences", "piecework_flag", "paid_period", "salary", "salary_base_range", "salary_base_bonus", "taxes", "is_company_car", "driving_license_category", "driving_experience", "delivery_method", "profession", "registration_method", "bonuses", "worker_class", "food_production_shop_type", "eatery_type", "cuisine", "medical_book", "facility_type", "retail_equipment_type", "retail_shop_type", "tools_availability", "construction_work_type", "work_format", "manufacturing_type", "industry_type", "programs", "warehouse_functionality", Example: params=address,schedule): Дополнительные поля, которые входят в params (можно указать несколько значений через запятую). По умолчанию отображаются все поля. deprecated: manufacturing_type, industry_type, programs, warehouse_functionality Header Parameters: - Authorization (required, string, Example: Bearer ACCESS_TOKEN): Токен для авторизации - X-Is-Employee (boolean, Nullable): Сотрудник компании получает информацию по вакансии, которую он опубликовал для компании Responses: 200: Успешный ответ 400: Неверный запрос 401: Требуется аутентификация 403: Пользователь не владелец объявления 404: Вакансия не найдена 500: Внутренняя ошибка метода API 503: Метод API временно недоступен ``` -------------------------------- ### Avito API Catalog Overview Source: https://developers.avito.ru/api-catalog/messenger/documentation This section lists the available Avito APIs, providing links to their respective documentation. It serves as a central entry point for developers to discover and access Avito's API services. ```APIDOC Accounts Hierarchy API: https://developers.avito.ru/api-catalog/accounts-hierarchy/documentation CPA-аукцион API: https://developers.avito.ru/api-catalog/auction/documentation Auth API: https://developers.avito.ru/api-catalog/auth/documentation Autoload API: https://developers.avito.ru/api-catalog/autoload/documentation Autostrategy API: https://developers.avito.ru/api-catalog/autostrategy/documentation Autoteka API: https://developers.avito.ru/api-catalog/autoteka/documentation CallTracking[КТ] API: https://developers.avito.ru/api-catalog/calltracking/documentation CPA Avito API: https://developers.avito.ru/api-catalog/cpa/documentation Настройка цены целевого действия API: https://developers.avito.ru/api-catalog/cpxpromo/documentation Доставка API: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Объявления API: https://developers.avito.ru/api-catalog/item/documentation Авито.Работа API: https://developers.avito.ru/api-catalog/job/documentation Мессенджер API: https://developers.avito.ru/api-catalog/messenger/documentation Управление заказами API: https://developers.avito.ru/api-catalog/order-management/documentation Рейтинги и отзывы API: https://developers.avito.ru/api-catalog/ratings/documentation Рассылка скидок и спецпредложений в мессенджере (beta-version) API: https://developers.avito.ru/api-catalog/sbc-gateway/documentation Управление остатками API: https://developers.avito.ru/api-catalog/stock-management/documentation Краткосрочная аренда API: https://developers.avito.ru/api-catalog/str/documentation Тарифы API: https://developers.avito.ru/api-catalog/tariff/documentation TrxPromo API: https://developers.avito.ru/api-catalog/trxpromo/documentation Информация о пользователе API: https://developers.avito.ru/api-catalog/user/documentation ``` -------------------------------- ### State Transition Rules and Examples Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation Explains the directed graph nature of parcel status transitions, where transitions are only allowed if an arrow exists between statuses. Provides examples of valid and forbidden transitions and recommends handling missed statuses. ```APIDOC State Transition Rules: Transitions are based on a directed graph; movement is only allowed along existing arrows. If an invalid transition is received, Avito will reject it, indicating the current status. Example Transitions: - Current: IN_TRANSIT, Received: RETURNED -> Forbidden - Current: IN_TRANSIT, Received: IN_TRANSIT_RETURN -> Success - Current: IN_TRANSIT_RETURN, Received: RETURNED -> Forbidden - Current: IN_TRANSIT_RETURN, Received: ON_DELIVERY_RETURN -> Success - Current: ON_DELIVERY_RETURN, Received: RETURNED -> Success Recommendations: - Implement backfilling of missed statuses using the `data.details.from` field. - If backfilling is not implemented, treat 'forbidden' transitions similarly to HTTP 500 errors, avoiding infinite retries of invalid transitions. ```