AdGuard VPN: Contract Studio

Support

Support

Tell us what happened and we will reply to the address you leave below.

This page is available in English, मराठी, Русский, Español (Latinoamérica), 한국어, हिन्दी, Македонски and ગુજરાતી. Each language section below says the same thing.

English

Getting started

Free app for versioned API contracts on iPhone and iPad, with an optional VPN tab. No account needed. On first launch the Studio tab has a sample contract, "Bookshop API", with two versions. New contract starts from a template, blank contract or import.

Compatibility and exports

Compatibility classifies changes between two versions as breaking, risky or safe and suggests a semantic version. Specs and exports lets you preview, copy, share or save OpenAPI 3.1 (JSON or YAML), a Markdown review document or an archive; exports leave your device only when you share or save them.

Importing

New contract, then Import from Files: OpenAPI 3.0 or 3.1 (JSON or YAML, up to 5 MB) or a contract archive. Shared files, text or links wait under Shared documents until you import or discard them.

Hosted mocks

In Mock endpoints, Publish mock gives a public link that answers with the example responses documented in that version. Up to 10 active mocks per installation. Anyone with the link can call a mock, so never put personal data or secrets in examples. Unpublish stops the link at once; unused mocks are removed after 90 days.

AI help

AI help drafts contracts, explains version changes, suggests example payloads and reviews versions. It is optional and off until you tap Agree and continue on the "Allow AI help?" screen; Not now sends nothing. Once allowed, only the text needed for the chosen action goes to the API Contract Studio AI Gateway, and OpenAI, OpenRouter and Google may process it. The privacy policy lists what each action sends. A daily allowance shows in the Copilot tab.

Settings, AI help, Withdraw permission turns it off; text already sent cannot be recalled. Report this result sends an AI result to us for review; report a hosted mock that misuses the service via the contact form on this page, with the mock link.

What the VPN is

The VPN tab sends your iPhone's or iPad's internet traffic through the app's own gateway, so websites see the gateway's address, not yours. It is free and does not make you anonymous. The privacy policy says exactly what is processed and what is not logged.

Connecting the VPN

  1. Open the VPN tab and tap Connect. The first time, read the app's notice and tap Agree and connect.
  2. The first time, iOS asks to add a VPN configuration: tap Allow and confirm with Face ID, Touch ID or your passcode.
  3. Wait for Connected, shown only after the app checks that your traffic really goes through the gateway. Gateway online only means the gateway can be reached; it is not proof of a connection.

Disconnecting, removing the VPN

  • Disconnect: tap Disconnect in the VPN tab or turn the VPN switch off in iOS Settings.
  • Remove the configuration: Settings in this app, Remove VPN configuration under VPN; or iOS Settings, General, VPN & Device Management, VPN, Delete VPN. Deleting the app removes it too.
  • Withdraw consent (same Settings section) disconnects the VPN and asks again before the next connection.

VPN limits

  • IPv4 only: IPv6 is blocked while the VPN is on, so IPv6-only services won't load until you disconnect.
  • One gateway: no choice of server or location.
  • Daily fair-use allowance and speed cap; once used up, the gateway ends the session and refuses new ones until the next UTC day.
  • Outgoing email on port 25 (SMTP) is blocked; ports 587 and 465 are unaffected.
  • Private and local addresses are unreachable through the gateway; devices on your own network, such as a printer, keep working as that traffic skips the VPN.
  • Sessions last at most 12 hours and end sooner if you disconnect, the gateway closes them or the allowance runs out; the VPN does not reconnect by itself in a loop.

The VPN does not connect

  • Preparing the connection (permission): allow the configuration when iOS asks, switch the VPN on in iOS Settings if it is off, or ask the administrator of a managed device.
  • Finding the gateway (resolve), or "The gateway could not be reached": check you are online and no network blocks the app's domain; try another network or later.
  • Starting the tunnel (provider) or Setting up the network (settings): reopen the app, restart the device, turn off other VPNs, remove the VPN configuration and reconnect.
  • Contacting the gateway (handshake): the gateway may be busy or off, your network may block it, or you started sessions too often; wait, then retry later or elsewhere.
  • Checking the connection (traffic): weak connection, allowance used up or a newer session replaced this one; disconnect, wait and reconnect.

Deleting my data

  • Delete a contract from its More actions menu, or everything via Settings, Your data, Delete all data; hosted mocks go offline (with Delete all data, when you are online). Removing the app deletes its data from the device.
  • Data on our server, such as reports: use the contact form on this page with the mock link or the report's date and wording.
  • The VPN keeps no record of the websites you visit that could be deleted; to stop it, disconnect and remove the configuration.

Widgets, shortcuts, offline

Widgets, controls, Siri, Shortcuts and Spotlight cover contracts and tasks; Track rollout on the Tasks board shows a Live Activity. Only mocks, AI help, reports and the VPN need the internet.

Contact us

Use the contact form on this page with your app version, device, iOS version and the steps to the problem; no passwords, secret keys or visited websites. For a VPN problem add the step where it stopped and whether you used Wi-Fi or mobile data.

मराठी

सुरुवात

हे iPhone आणि iPad वर आवृत्त्या असलेले API करार तयार करण्यासाठीचे मोफत अ‍ॅप आहे, आणि VPN टॅबमध्ये ऐच्छिक VPN आहे. खात्याची गरज नाही. पहिल्यांदा उघडल्यावर Studio टॅबमध्ये दोन आवृत्त्यांचा "Bookshop API" हा नमुना करार असतो. टेम्पलेट, रिकामा करार किंवा इम्पोर्टपासून सुरू करण्यासाठी New contract वर टॅप करा.

सुसंगतता आणि एक्सपोर्ट

Compatibility दोन आवृत्त्यांमधील बदल breaking, risky किंवा safe असा वर्गीकृत करते आणि semantic version सुचवते. Specs and exports मध्ये OpenAPI 3.1 (JSON किंवा YAML), Markdown पुनरावलोकन दस्तऐवज किंवा पूर्ण करार संग्रह शेअर किंवा सेव्ह करता येतो; शेअर किंवा सेव्ह केल्यावरच एक्सपोर्ट डिव्हाइसबाहेर जातात.

इम्पोर्ट

New contract, नंतर Import from Files: OpenAPI 3.0 किंवा 3.1 दस्तऐवज (JSON किंवा YAML, 5 MB पर्यंत) किंवा करार संग्रह; शेअर केलेल्या गोष्टी Shared documents मध्ये थांबतात.

होस्टेड मॉक

Mock endpoints, Publish mock वर टॅप केल्यावर त्या आवृत्तीत दस्तऐवजीकृत उदाहरण उत्तरे देणारी सार्वजनिक लिंक मिळते. प्रत्येक इन्स्टॉलेशन 10 पर्यंत सक्रिय मॉक ठेवू शकते. लिंक असलेला कोणीही मॉकला कॉल करू शकतो, म्हणून उदाहरणांमध्ये वैयक्तिक डेटा किंवा गुपिते ठेवू नका. Unpublish केल्यावर लिंक लगेच बंद होते; वापर न झालेले मॉक 90 दिवसांनी काढले जातात.

AI मदत

AI मदत करार मसुदा तयार करते, आवृत्त्यांमधील बदल समजावते, उदाहरण payload सुचवते आणि आवृत्तीचे पुनरावलोकन करते. ती ऐच्छिक आहे आणि "Allow AI help?" स्क्रीनवर Agree and continue वर टॅप करेपर्यंत बंद असते; Not now काहीही पाठवत नाही. परवानगी दिल्यावर तुम्ही निवडलेल्या कृतीसाठी आवश्यक मजकूरच API Contract Studio AI Gateway ला पाठवला जातो आणि OpenAI, OpenRouter आणि Google त्यावर प्रक्रिया करू शकतात. प्रत्येक कृती नेमके काय पाठवते ते गोपनीयता धोरणात दिले आहे. दैनिक मर्यादा आहे, ती Copilot टॅबमध्ये दिसते.

Settings मध्ये AI help, Withdraw permission वर टॅप केल्यावर ती बंद होते; त्यानंतर काहीही पाठवले जात नाही आणि आधी पाठवलेला मजकूर परत घेता येत नाही. AI निकालाबद्दल Report this result वापरा; सेवेचा गैरवापर करणाऱ्या होस्टेड मॉकबद्दल या पेजवरील संपर्क फॉर्म वापरा आणि मॉक लिंक द्या.

VPN म्हणजे काय?

VPN टॅब तुमच्या iPhone किंवा iPad चा इंटरनेट ट्रॅफिक अ‍ॅपच्या स्वतःच्या गेटवेमार्फत पाठवतो, त्यामुळे वेबसाइटना तुमच्या ऐवजी गेटवेचा पत्ता दिसतो. तो मोफत आहे आणि तुम्हाला अनामिक बनवत नाही. काय प्रक्रिया होते आणि काय नोंदवले जात नाही ते गोपनीयता धोरणात नेमके सांगितले आहे.

VPN शी कसे कनेक्ट करू?

  1. VPN टॅब उघडा आणि कनेक्ट करा वर टॅप करा. पहिल्या वेळी सूचना दिसते: ती वाचा आणि "सहमत आहे, कनेक्ट करा" वर टॅप करा.
  2. पहिल्यांदा iOS VPN कॉन्फिगरेशन जोडण्यासाठी स्वतःचा संदेश दाखवते: Allow वर टॅप करा आणि Face ID, Touch ID किंवा पासकोडने पुष्टी करा.
  3. "कनेक्ट केले" दिसेपर्यंत थांबा; तुमचा ट्रॅफिक खरोखर गेटवेमधून जातो हे तपासल्यानंतरच ते दिसते. "गेटवे ऑनलाइन आहे" चा अर्थ फक्त गेटवेपर्यंत पोहोचता येते एवढाच आहे; ते कनेक्शनचा पुरावा नाही.

डिस्कनेक्ट आणि VPN काढणे

  • डिस्कनेक्ट: VPN टॅबमध्ये डिस्कनेक्ट करा वर टॅप करा किंवा iOS सेटिंग्जमध्ये VPN स्विच बंद करा.
  • कॉन्फिगरेशन काढणे: या अ‍ॅपमध्ये सेटिंग्ज उघडा आणि VPN विभागात "VPN कॉन्फिगरेशन काढा" निवडा, किंवा iOS सेटिंग्ज → General → VPN & Device Management → VPN → Delete VPN. अ‍ॅप हटवल्यानेही ते काढले जाते.
  • "संमती मागे घ्या" (त्याच विभागात) VPN डिस्कनेक्ट करते आणि पुढच्या कनेक्शनपूर्वी पुन्हा विचारले जाते.

VPN च्या मर्यादा

  • फक्त IPv4: VPN चालू असताना IPv6 ट्रॅफिक ब्लॉक केला जातो, त्यामुळे फक्त IPv6 वर पोहोचता येणारी सेवा तुम्ही डिस्कनेक्ट करेपर्यंत लोड होणार नाही.
  • एकच गेटवे: सर्व्हर किंवा ठिकाण निवडता येत नाही.
  • वाजवी वापराची दैनिक मर्यादा आणि वेगाची कमाल मर्यादा; मर्यादा संपल्यावर गेटवे सेशन संपवतो आणि पुढचा UTC दिवस येईपर्यंत नवीन सेशन नाकारतो.
  • पोर्ट 25 (SMTP) वरील आउटगोइंग ईमेल ब्लॉक आहे; पोर्ट 587 किंवा 465 वर परिणाम होत नाही.
  • खासगी आणि स्थानिक पत्त्यांपर्यंत गेटवेमार्फत पोहोचता येत नाही; तुमच्या नेटवर्कवरील डिव्हाइस चालूच राहतात, कारण तो ट्रॅफिक VPN मधून जात नाही.
  • सेशन जास्तीत जास्त 12 तास चालते आणि डिस्कनेक्ट केल्यास, गेटवेने बंद केल्यास किंवा मर्यादा संपल्यास लवकर संपते; VPN स्वतःहून पुन्हा कनेक्ट होत नाही.

VPN कनेक्ट होत नाही

  • कनेक्शनची तयारी सुरू आहे (permission): iOS ने विचारल्यावर VPN कॉन्फिगरेशनला परवानगी द्या; iOS सेटिंग्जमध्ये VPN बंद असल्यास चालू करा; व्यवस्थापित डिव्हाइसवर प्रशासकाला विचारा.
  • गेटवे शोधत आहे (resolve) किंवा "गेटवेशी संपर्क होऊ शकला नाही": तुम्ही ऑनलाइन आहात का आणि एखादे नेटवर्क अ‍ॅपचे डोमेन ब्लॉक करते का ते तपासा; दुसरे नेटवर्क वापरा किंवा नंतर प्रयत्न करा.
  • टनेल सुरू होत आहे (provider) किंवा नेटवर्क सेट करत आहे (settings): अ‍ॅप बंद करून पुन्हा उघडा, डिव्हाइस रीस्टार्ट करा, इतर VPN बंद करा, VPN कॉन्फिगरेशन काढा आणि पुन्हा कनेक्ट करा.
  • गेटवेशी संपर्क साधत आहे (handshake): गेटवे व्यग्र किंवा बंद असू शकतो, नेटवर्क रोखत असू शकते, किंवा सेशन खूप वेळा सुरू केले असतील; नंतर किंवा दुसऱ्या नेटवर्कवर प्रयत्न करा.
  • कनेक्शन तपासत आहे (traffic): कनेक्शन कमकुवत, दैनिक मर्यादा संपलेली किंवा नवीन सेशनने हे बदललेले असू शकते; डिस्कनेक्ट करा, थोडा वेळ थांबा आणि पुन्हा कनेक्ट करा.

माझा डेटा कसा हटवू?

  • करार त्याच्या More actions मेनूमधून हटवा, किंवा सर्व काही Settings, Your data, Delete all data मधून; होस्टेड मॉक ऑफलाइन होतात (Delete all data सह, ऑनलाइन असताना). अ‍ॅप काढल्यास त्याचा डेटा डिव्हाइसवरून हटतो.
  • आमच्या सर्व्हरवरील डेटा (उदा. रिपोर्ट): या पेजवरील संपर्क फॉर्म वापरा, मॉक लिंक किंवा रिपोर्टची तारीख द्या.
  • तुम्ही भेट दिलेल्या वेबसाइटच्या हटवता येतील अशा नोंदी VPN ठेवत नाही; ते थांबवण्यासाठी डिस्कनेक्ट करा आणि VPN कॉन्फिगरेशन काढा.

विजेट्स, शॉर्टकट, ऑफलाइन

विजेट्स, कंट्रोल्स, Siri, Shortcuts आणि Spotlight; Tasks बोर्डवर Track rollout Live Activity दाखवते. मॉक, AI मदत, रिपोर्ट आणि VPN वगळता सर्व काही ऑफलाइन चालते.

संपर्क

या पेजवरील संपर्क फॉर्म वापरा: अ‍ॅप आवृत्ती, डिव्हाइस, iOS आवृत्ती आणि समस्येपर्यंतच्या पायऱ्या द्या; पासवर्ड, गुप्त की किंवा भेट दिलेल्या वेबसाइट नकोत. VPN ची समस्या असल्यास कनेक्शन कोणत्या टप्प्यावर थांबले आणि तुम्ही Wi-Fi वर होता की मोबाइल डेटावर ते सांगा.

Русский

С чего начать

Бесплатное приложение для версионируемых API-контрактов на iPhone и iPad с необязательным VPN. Учётная запись не нужна. При первом запуске на вкладке Studio есть пример контракта «Bookshop API» с двумя версиями. Нажмите New contract: шаблон, пустой контракт или импорт.

Совместимость и экспорт

Compatibility отмечает изменения между версиями как breaking, risky или safe и предлагает семантическую версию. Specs and exports: отправить или сохранить OpenAPI 3.1 (JSON или YAML), документ для ревью в Markdown или полный архив контракта; экспорт покидает устройство, только если вы делитесь им или сохраняете.

Импорт

New contract, затем Import from Files: документ OpenAPI 3.0 или 3.1 (JSON или YAML, до 5 МБ) или архив контракта. Полученное из другого приложения ждёт в Shared documents.

Размещённые моки

Publish mock в Mock endpoints даёт публичную ссылку, отвечающую задокументированными в этой версии примерами. До 10 активных моков на установку. Вызвать мок может любой, у кого есть ссылка, поэтому не помещайте в примеры персональные данные и секреты. Unpublish сразу отключает ссылку; неиспользуемые моки удаляются через 90 дней.

Помощь ИИ

Помощь ИИ составляет контракты, объясняет изменения версий, предлагает примеры данных и проводит ревью. Она необязательна и выключена, пока вы не нажмёте Agree and continue на экране «Allow AI help?»; Not now ничего не отправляет. После разрешения в API Contract Studio AI Gateway отправляется только текст, нужный для выбранного действия, и его могут обрабатывать OpenAI, OpenRouter и Google. Что отправляет каждое действие, указано в политике конфиденциальности. Дневной лимит виден на вкладке Copilot.

Settings, AI help, Withdraw permission выключает помощь: ничего больше не отправляется; уже отправленный текст вернуть нельзя. Report this result отправляет результат ИИ нам на проверку; о размещённом моке, используемом во вред, сообщите через форму обратной связи на этой странице со ссылкой на мок.

Что такое VPN?

Вкладка VPN направляет интернет-трафик вашего iPhone или iPad через собственный шлюз приложения, поэтому сайты видят адрес шлюза, а не ваш. VPN бесплатный и не делает вас анонимным. В политике конфиденциальности точно сказано, что обрабатывается и что не записывается.

Подключение к VPN

  1. Откройте вкладку VPN и нажмите «Подключить». В первый раз прочитайте уведомление и нажмите «Принять и подключить».
  2. В первый раз iOS запросит добавить конфигурацию VPN: нажмите «Разрешить» и подтвердите Face ID, Touch ID или кодом-паролем.
  3. Дождитесь «Подключено» — оно появляется только после проверки, что трафик действительно идёт через шлюз. «Шлюз в сети» означает лишь, что шлюз доступен, и не доказывает наличие соединения.

Отключение и удаление VPN

  • Отключение: нажмите «Отключить» на вкладке VPN или выключите переключатель VPN в настройках iOS.
  • Удаление конфигурации: «Настройки» в приложении, раздел «VPN», «Удалить конфигурацию VPN»; либо настройки iOS → «Основные» → «VPN и управление устройством» → VPN → «Удалить VPN». При удалении приложения конфигурация тоже удаляется.
  • «Отозвать согласие» в том же разделе отключает VPN и перед следующим подключением спрашивает снова.

Ограничения VPN

  • Только IPv4: пока VPN включён, трафик IPv6 блокируется, и сервисы только с IPv6 не загрузятся до отключения.
  • Один шлюз: выбрать сервер или местоположение нельзя.
  • Дневной лимит честного использования и ограничение скорости; при исчерпании лимита шлюз завершает сеанс и не принимает новые до начала следующих суток по UTC.
  • Исходящая почта через порт 25 (SMTP) заблокирована; порты 587 и 465 не затронуты.
  • К частным и локальным адресам через шлюз обратиться нельзя; устройства в вашей сети работают, так как этот трафик не идёт через VPN.
  • Сеанс длится не более 12 часов и завершается раньше, если вы отключитесь, шлюз его закроет или лимит исчерпан; VPN не переподключается по кругу.

VPN не подключается

  • Подготовка подключения (permission): разрешите конфигурацию, когда iOS спросит; включите VPN в настройках iOS, если он выключен; на управляемом устройстве спросите администратора.
  • Поиск шлюза (resolve) или «Не удалось связаться со шлюзом»: проверьте подключение и не блокирует ли сеть домен приложения; попробуйте другую сеть или позже.
  • Запуск туннеля (provider) или Настройка сети (settings): откройте приложение заново, перезагрузите устройство, отключите другие VPN, удалите конфигурацию VPN и подключитесь заново.
  • Связь со шлюзом (handshake): шлюз занят или выключен, сеть его блокирует или сеансы запускались слишком часто; повторите позже или в другой сети.
  • Проверка подключения (traffic): слабая связь, исчерпан лимит или сеанс заменил более новый; отключитесь, подождите и подключитесь снова.

Как удалить свои данные?

  • Удалите контракт через меню More actions или всё через Settings, Your data, Delete all data; размещённые моки отключатся (при Delete all data — если вы в сети). Удаление приложения удаляет его данные с устройства.
  • Данные на сервере, например жалобы: форма обратной связи на этой странице, со ссылкой на мок или датой жалобы.
  • VPN не хранит записей о посещённых сайтах, которые можно удалить; чтобы остановить его, отключитесь и удалите конфигурацию.

Виджеты, быстрые команды, офлайн

Есть виджеты, элементы управления, Siri, «Команды» и Spotlight; на доске Tasks Track rollout показывает Live Activity. Без интернета работает всё, кроме моков, помощи ИИ, жалоб и VPN.

Связаться с нами

Используйте форму обратной связи на этой странице: версия приложения, устройство, версия iOS и шаги к проблеме; без паролей, секретных ключей и посещённых сайтов. При проблеме с VPN назовите шаг, на котором остановилось подключение, и сеть (Wi-Fi или мобильная).

Español (Latinoamérica)

Primeros pasos

App gratuita para contratos de API con versiones en iPhone y iPad, con una VPN opcional. No necesitas cuenta. Al inicio, Studio incluye un contrato de ejemplo, "Bookshop API", con dos versiones. New contract parte de una plantilla, un contrato en blanco o una importación.

Compatibilidad y exportación

Compatibility clasifica los cambios entre dos versiones como breaking, risky o safe y sugiere una versión semántica. Specs and exports permite compartir o guardar OpenAPI 3.1 (JSON o YAML), un documento de revisión en Markdown o un archivo; las exportaciones solo salen del dispositivo si las compartes o guardas.

Importación

New contract, luego Import from Files: OpenAPI 3.0 o 3.1 (JSON o YAML, hasta 5 MB) o un archivo de contrato. Lo compartido desde otra app espera en Shared documents.

Mocks alojados

En Mock endpoints, Publish mock crea un enlace público que responde con los ejemplos documentados de esa versión. Hasta 10 mocks activos por instalación. Cualquiera con el enlace puede llamar a un mock: no pongas datos personales ni secretos en los ejemplos. Unpublish lo desactiva al instante; los mocks sin uso se eliminan a los 90 días.

Ayuda de IA

La ayuda de IA redacta contratos, explica cambios, sugiere ejemplos y revisa versiones. Es opcional y está desactivada hasta que tocas Agree and continue en la pantalla "Allow AI help?"; Not now no envía nada. Con tu permiso, solo se envía el texto necesario para la acción elegida a API Contract Studio AI Gateway, y OpenAI, OpenRouter y Google pueden procesarlo. La política de privacidad detalla qué envía cada acción. El límite diario aparece en la pestaña Copilot.

Settings, AI help, Withdraw permission la desactiva; el texto ya enviado no se puede recuperar. Report this result envía a revisión un resultado de IA; para un mock alojado que haga mal uso del servicio, usa el formulario de contacto de esta página con su enlace.

¿Qué es la VPN?

La pestaña VPN envía el tráfico de internet de tu iPhone o iPad por el gateway (puerta de enlace) propio de la app, así que los sitios ven la dirección del gateway, no la tuya. Es gratuita y no te hace anónimo. La política de privacidad explica exactamente qué se procesa y qué no se registra.

Conectar la VPN

  1. Abre la pestaña VPN y toca Conectar. La primera vez, lee el aviso y toca Aceptar y conectar.
  2. La primera vez, iOS pide agregar una configuración de VPN: toca Permitir y confirma con Face ID, Touch ID o tu código.
  3. Espera a Conectado, que solo aparece tras comprobar que tu tráfico pasa por el gateway. "Puerta de enlace en línea" solo significa que se puede llegar al gateway; no prueba que haya una conexión.

Desconectar o quitar la VPN

  • Desconectar: toca Desconectar en la pestaña VPN o apaga el interruptor de VPN en Configuración de iOS.
  • Quitar la configuración: Configuración de esta app, sección VPN, Quitar la configuración de VPN; o Configuración de iOS, General, VPN y administración de dispositivos, VPN, Eliminar VPN. Al eliminar la app también se quita.
  • Retirar el consentimiento (misma sección) desconecta la VPN y la app vuelve a preguntar antes de la siguiente conexión.

Límites de la VPN

  • Solo IPv4: el tráfico IPv6 se bloquea con la VPN activada, así que los servicios solo IPv6 no cargan hasta que te desconectes.
  • Un solo gateway: no se elige servidor ni ubicación.
  • Cupo diario de uso razonable y tope de velocidad; al agotarse, el gateway termina la sesión y rechaza nuevas hasta el siguiente día UTC.
  • El correo saliente por el puerto 25 (SMTP) está bloqueado; los puertos 587 y 465 no se ven afectados.
  • Las direcciones privadas y locales no son accesibles por el gateway; los dispositivos de tu red siguen funcionando porque ese tráfico no usa la VPN.
  • Una sesión dura hasta 12 horas y termina antes si te desconectas, el gateway la cierra o se agota el cupo; no se reconecta sola en bucle.

La VPN no se conecta

  • Preparando la conexión (permission): permite la configuración cuando iOS lo pida, activa la VPN en Configuración de iOS si está apagada o consulta al administrador.
  • Buscando la puerta de enlace (resolve) o "No se pudo acceder a la puerta de enlace": revisa tu conexión y que ninguna red bloquee el dominio de la app; prueba otra red o más tarde.
  • Iniciando el túnel (provider) o Configurando la red (settings): reabre la app, reinicia el dispositivo, apaga otras VPN, quita la configuración de VPN y reconecta.
  • Contactando la puerta de enlace (handshake): gateway ocupado o apagado, red que lo bloquea o sesiones iniciadas con demasiada frecuencia; espera y reintenta más tarde o en otra red.
  • Verificando la conexión (traffic): conexión débil, cupo agotado o una sesión más nueva la reemplazó; desconéctate, espera y reconecta.

Borrar mis datos

  • Borra un contrato desde su menú More actions, o todo desde Settings, Your data, Delete all data; los mocks alojados se desconectan (con Delete all data, si estás en línea). Eliminar la app borra sus datos del dispositivo.
  • Datos en nuestro servidor, como reportes: formulario de contacto, con el enlace del mock o la fecha del reporte.
  • La VPN no guarda registros borrables de los sitios que visitas; para detenerla, desconéctate y quita la configuración.

Widgets, atajos y sin conexión

Hay widgets, controles, Siri, Atajos y Spotlight; en Tasks, Track rollout muestra una Live Activity. Sin conexión funciona todo salvo los mocks, la ayuda de IA, los reportes y la VPN.

Contáctanos

Usa el formulario de contacto de esta página con la versión de la app, el dispositivo, la de iOS y los pasos del problema; sin contraseñas, claves ni sitios visitados. Si es la VPN, indica el paso donde se detuvo y si usabas Wi-Fi o datos móviles.

한국어

시작하기

이 앱은 iPhone과 iPad에서 버전이 있는 API 계약을 설계하는 무료 앱이며, VPN 탭에 선택형 VPN이 있습니다. 계정이 필요 없습니다. 처음 실행하면 Studio 탭에 두 개의 버전이 있는 예시 계약 "Bookshop API"가 있어 살펴보고 편집할 수 있습니다. 템플릿, 빈 계약 또는 가져오기로 시작하려면 New contract를 탭하세요.

변경 사항이 클라이언트를 깨뜨리는지 어떻게 확인하나요?

계약을 열고 Compatibility로 이동하세요. 두 버전을 고르면 모든 변경이 breaking, risky, safe로 분류되고 권장 시맨틱 버전이 표시됩니다. Rules에서 계약의 호환성 정책을 고를 수 있습니다.

명세는 어떻게 내보내나요?

계약을 열고 Specs and exports로 이동하세요. OpenAPI 3.1(JSON 또는 YAML), Markdown 검토 문서, 무손실 계약 아카이브를 미리 보고, 복사하고, 공유하거나 저장할 수 있습니다. 내보내기는 직접 공유하거나 저장할 때만 기기를 떠납니다.

기존 API는 어떻게 가져오나요?

New contract에서 Import from Files를 탭하고 OpenAPI 3.0 또는 3.1 문서(JSON 또는 YAML, 최대 5MB)나 계약 아카이브를 선택하세요. 다른 앱에서 파일, 텍스트, HTTPS 링크를 이 앱으로 공유할 수도 있으며, 가져오거나 버릴 때까지 Shared documents에 보관됩니다.

호스팅 목은 어떻게 작동하나요?

계약을 열고 Mock endpoints에서 Publish mock을 탭하세요. 해당 버전에 문서화된 예시 응답으로 답하는 공개 링크가 생깁니다. Try a request로 앱에서 호출하고, 상태 코드를 바꾸거나 최대 3,000ms 지연을 추가할 수 있으며, Live traffic에서 최근 호출을 볼 수 있습니다. 다른 도구에서는 X-Mock-Status 헤더나 __status 쿼리 매개변수로 문서화된 상태를 고를 수 있습니다. 설치마다 활성 목을 최대 10개까지 둘 수 있습니다. 링크를 가진 누구나 목을 호출할 수 있으므로 예시에 개인정보나 비밀 정보를 넣지 마세요. Unpublish하면 링크가 즉시 중단되며, 사용하지 않는 목은 90일 후 삭제됩니다.

AI 도움은 무엇을 하고 무엇이 전송되나요?

AI 도움은 설명으로 계약 초안을 만들고, 버전 간 변경을 설명하고, 예시 페이로드를 제안하고, 버전을 검토합니다. 선택 사항이며 "Allow AI help?" 화면에서 Agree and continue를 탭하기 전까지 꺼져 있습니다. Not now는 아무것도 보내지 않습니다. 허용하면 선택한 작업에 필요한 텍스트만 API Contract Studio AI Gateway로 전송되며 OpenAI, OpenRouter, Google이 이를 처리할 수 있습니다. 작업별 전송 내용은 개인정보처리방침에 정확히 나와 있습니다. AI 결과는 적용 전에 검토하는 제안입니다. 일일 한도가 있으며 Copilot 탭에 표시됩니다.

AI 도움을 다시 끄려면 어떻게 하나요?

Settings의 AI help에서 Withdraw permission을 탭하세요. 그 후에는 아무것도 전송되지 않으며 이미 보낸 텍스트는 되돌릴 수 없습니다. 나중에 아무 AI 작업에서나 다시 허용할 수 있습니다.

AI 결과나 목은 어떻게 신고하나요?

AI 결과 아래의 Report this result를 탭하고 짧은 메모를 적어 보내세요. 신고는 검토를 위해 당사로 전달되며 한도에 포함되지 않습니다. 서비스를 악용하는 호스팅 목을 신고하려면 이 페이지의 문의 양식에 목 링크를 함께 적어 보내 주세요.

VPN은 무엇이며 무엇을 하나요?

VPN 탭은 iPhone 또는 iPad의 인터넷 트래픽을 앱의 자체 게이트웨이를 통해 보내므로 웹사이트에는 사용자의 주소 대신 게이트웨이의 주소가 보입니다. 무료이고 계정이 필요 없으며 게이트웨이가 하나(서버나 위치 선택 없음)이고 공정 사용 일일 허용량이 있습니다. 익명성을 제공하지는 않습니다. 무엇을 처리하고 무엇을 기록하지 않는지는 개인정보처리방침에 정확히 나와 있습니다.

VPN에 어떻게 연결하나요?

  1. VPN 탭을 엽니다.
  2. 처음에는 안내를 읽고 동의합니다. 동의하지 않으면 아무것도 시작되지 않고 앱의 나머지 기능은 계속 작동합니다.
  3. 연결을 탭합니다. 처음에는 iOS가 VPN 구성 추가를 위한 자체 창을 표시합니다. 허용을 탭하고 Face ID, Touch ID 또는 암호로 확인하세요.
  4. "연결됨"이 표시될 때까지 기다립니다. 앱은 트래픽이 실제로 게이트웨이를 거치는지 확인한 뒤에만 "연결됨"을 표시합니다. "게이트웨이 온라인" 상태는 게이트웨이에 접속할 수 있다는 뜻일 뿐 연결되었다는 증거가 아닙니다.

보이는 주소 카드는 웹사이트에 보이는 주소를 보여 주며, 연결하면 바뀝니다.

VPN 연결을 끊거나 VPN 구성을 제거하려면 어떻게 하나요?

  • 연결 끊기: VPN 탭에서 연결 해제를 탭하거나 iOS 설정에서 VPN 스위치를 끕니다.
  • 구성 제거: 이 앱의 설정을 열어 VPN 아래의 VPN 구성 삭제를 선택하거나, iOS 설정 > 일반 > VPN 및 기기 관리 > VPN을 열고 앱 VPN 옆의 정보 버튼을 탭한 다음 VPN 삭제를 선택합니다. 같은 설정 항목의 동의 철회를 선택하면 VPN 연결이 해제되며, 다음 연결 전에 다시 동의를 구합니다. 앱을 삭제해도 구성이 제거됩니다. 나중에 다시 연결하면 iOS가 권한을 다시 요청합니다.

VPN에는 어떤 제한이 있나요?

  • IPv4만 지원: VPN이 켜져 있는 동안 앱이 IPv4를 사용하도록 IPv6 트래픽이 차단됩니다. IPv6로만 접속되는 서비스는 연결을 끊을 때까지 로드되지 않습니다.
  • TCP와 UDP 트래픽만 전달합니다. ping 등 다른 종류의 트래픽은 VPN으로 작동하지 않습니다.
  • 게이트웨이는 하나: 서버나 위치를 고를 수 없습니다.
  • 공정 사용 일일 허용량과 속도 상한이 있습니다. 허용량을 모두 쓰면 게이트웨이가 세션을 종료하고 다음 UTC 날짜까지 새 세션을 거부합니다.
  • 설치당 한 번에 하나의 연결: 새로 시작하면 이전 연결이 종료되며, 세션을 너무 자주 시작하는 것도 제한됩니다.
  • 25번 포트(SMTP)로 나가는 이메일은 차단됩니다. 587번 또는 465번 포트로 보내는 메일 앱은 영향을 받지 않습니다.
  • 사설 및 로컬 주소에는 게이트웨이를 통해 접근할 수 없습니다. 집 Wi-Fi의 프린터처럼 사용자 자신의 네트워크에 있는 기기는 해당 트래픽이 VPN을 거치지 않으므로 계속 작동합니다.
  • 세션은 최대 12시간 지속되며, 연결을 끊거나 게이트웨이가 닫거나 허용량을 모두 쓰면 더 일찍 끝납니다. VPN은 스스로 반복해서 다시 연결하지 않으므로 앱을 열어 다시 연결하세요.
  • iOS에서는 한 번에 하나의 VPN만 활성화할 수 있으므로 다른 VPN을 먼저 끄세요.
  • 일부 웹사이트와 서비스는 공유 주소를 차단하므로 VPN으로는 작동하지 않을 수 있습니다.

VPN이 연결되지 않습니다. 무엇을 확인해야 하나요?

VPN 탭에는 연결하는 동안 각 단계의 이름이 표시되므로 어디서 멈췄는지 알 수 있습니다. 아래에서 해당 단계를 찾아보세요.

  • 연결을 준비하는 중(permission): iOS가 VPN 구성을 허용하지 않았습니다. 예를 들어 허용 안 함을 탭했거나, Face ID 또는 암호 확인이 취소되었거나, 기기 관리 프로파일이 VPN을 막는 경우입니다. 연결을 다시 탭해 허용하세요. 관리되는 기기라면 관리자에게 문의하세요. 메시지에 iOS 설정에서 VPN이 꺼져 있다고 나오면 그곳에서 켜 주세요.
  • 게이트웨이를 찾는 중(resolve): 기기가 게이트웨이의 주소를 찾지 못했습니다. 인터넷에 연결되어 있는지 확인하고 다른 네트워크(Wi-Fi 또는 모바일 데이터)로 다시 시도하세요.
  • 터널을 시작하는 중(provider): iOS가 앱의 VPN 구성 요소를 시작하지 못했습니다. 앱을 닫았다가 다시 열고 기기를 다시 시작하세요. 계속 실패하면 VPN 구성을 제거(위 참조)한 뒤 다시 연결하세요.
  • 네트워크를 설정하는 중(settings): iOS가 VPN의 네트워크 설정을 받아들이지 않았습니다. 다른 VPN을 끄고 VPN 구성을 제거한 뒤 다시 연결하세요.
  • 게이트웨이와 통신하는 중(handshake): 앱이 게이트웨이 주소에는 도달했지만 응답을 받지 못했습니다. 게이트웨이가 바쁘거나 일시적으로 꺼져 있거나, 네트워크가 연결을 막거나, 세션을 너무 자주 시작했을 수 있습니다(잠시 기다리세요). 나중에 또는 다른 네트워크에서 다시 시도하세요.
  • 연결을 확인하는 중(traffic): VPN은 시작되었지만 데이터가 지나가지 않거나 시작 후 멈췄습니다. 연결이 약하거나, 일일 허용량을 모두 썼거나, 더 새로운 세션이 이 세션을 대체했을 수 있습니다. 연결을 끊고 잠시 기다린 뒤 다시 연결하세요.
  • 게이트웨이에 연결할 수 없습니다: 네트워크 연결을 확인하고, 네트워크가 앱의 도메인을 차단하고 있지 않은지 확인한 다음 나중에 다시 시도하세요.

그래도 해결되지 않으면 문의해 주시고 멈춘 단계를 알려 주세요.

데이터는 어떻게 삭제하나요?

  • 계약의 More actions 메뉴에서 계약을 삭제하면 해당 호스팅 목도 내려갑니다.
  • Settings, Your data, Delete all data는 이 기기의 모든 계약, 버전, 작업, 대기 중인 공유 문서를 삭제하고 온라인 상태이면 호스팅 목도 내립니다.
  • 앱을 제거하면 기기에서 앱 데이터가 삭제됩니다.
  • 신고처럼 당사 서버에 보관된 데이터를 삭제하려면 이 페이지의 문의 양식을 이용하세요. 찾을 수 있도록 목 링크나 신고 날짜와 문구를 적어 주세요.
  • VPN은 삭제할 수 있는 방문 사이트 기록을 보관하지 않습니다. VPN을 중지하려면 연결을 끊고 위 설명대로 VPN 구성을 제거하세요.

위젯, 단축어, 검색

홈 화면이나 잠금 화면에 앱 위젯을 추가하고, 제어 센터의 컨트롤을 사용하고, Siri나 단축어 앱으로 계약과 작업을 만들거나 열고, Spotlight에서 계약을 찾을 수 있습니다. Tasks 보드의 Track rollout은 진행 상황을 Live Activity로 보여 줍니다.

오프라인에서도 작동하나요?

네. 편집, 호환성 검사, 검토, 작업, 내보내기는 연결 없이 작동합니다. 호스팅 목, AI 도움, 신고에는 인터넷이 필요합니다. VPN도 인터넷이 필요합니다.

문의하기

이 페이지의 문의 양식을 이용해 주세요. 앱 버전(Settings, Version), 기기와 iOS 버전, 문제가 발생하는 단계를 알려 주세요. 비밀번호나 비밀 키는 보내지 마세요. VPN 문제라면 연결이 멈춘 단계(permission, resolve, provider, settings, handshake, traffic)와 Wi-Fi인지 모바일 데이터인지도 알려 주세요. 방문한 사이트는 적지 말아 주세요.

हिन्दी

शुरुआत

यह iPhone और iPad पर वर्ज़न वाले API कॉन्ट्रैक्ट डिज़ाइन करने का मुफ़्त ऐप है; VPN टैब में वैकल्पिक VPN है। खाता नहीं चाहिए। Studio टैब में नमूना कॉन्ट्रैक्ट "Bookshop API" है; टेम्पलेट, खाली कॉन्ट्रैक्ट या इम्पोर्ट से शुरू करने के लिए New contract टैप करें।

संगतता

कॉन्ट्रैक्ट → Compatibility: दो वर्ज़न चुनें; बदलाव breaking, risky या safe में बँटते हैं, साथ में सुझाया semantic version। Rules में नीति चुनें।

एक्सपोर्ट

कॉन्ट्रैक्ट → Specs and exports: OpenAPI 3.1 (JSON/YAML), Markdown समीक्षा दस्तावेज़ या कॉन्ट्रैक्ट आर्काइव देखें, कॉपी, शेयर या सेव करें; एक्सपोर्ट शेयर या सेव करने पर ही डिवाइस से बाहर जाते हैं।

इम्पोर्ट

New contract → Import from Files: OpenAPI 3.0/3.1 दस्तावेज़ (JSON/YAML, 5 MB तक) या कॉन्ट्रैक्ट आर्काइव। दूसरे ऐप से फ़ाइल, टेक्स्ट या HTTPS लिंक शेयर करें; वह इम्पोर्ट या हटाने तक Shared documents में रहता है।

होस्टेड मॉक

कॉन्ट्रैक्ट → Mock endpoints → Publish mock: उदाहरण जवाब देने वाला सार्वजनिक लिंक। Try a request से ऐप में कॉल करें, स्टेटस बदलें या 3,000 ms तक देरी जोड़ें; दूसरे टूल से X-Mock-Status हेडर या __status query पैरामीटर से स्टेटस चुनें। प्रति इंस्टॉलेशन 10 तक सक्रिय मॉक। लिंक वाला कोई भी कॉल कर सकता है: उदाहरणों में निजी डेटा या गोपनीय जानकारी न डालें। Unpublish से लिंक तुरंत बंद; अनुपयोगी मॉक 90 दिन बाद हटते हैं।

AI मदद

AI मदद ड्राफ़्ट, बदलावों की व्याख्या, उदाहरण payload और वर्ज़न की समीक्षा देती है। यह वैकल्पिक है, "Allow AI help?" स्क्रीन पर Agree and continue टैप करने तक बंद; Not now कुछ नहीं भेजता। अनुमति के बाद चुने कार्य का ज़रूरी टेक्स्ट ही API Contract Studio AI Gateway को जाता है, जिसे OpenAI, OpenRouter और Google प्रोसेस कर सकते हैं; ब्योरा गोपनीयता नीति में है। नतीजे सुझाव हैं, लागू करने से पहले जाँचें। दैनिक सीमा Copilot टैब में दिखती है।

Settings → AI help → Withdraw permission से बंद करें: आगे कुछ नहीं भेजा जाता, भेजा टेक्स्ट वापस नहीं होता; बाद में फिर अनुमति दे सकते हैं। नतीजे के नीचे Report this result से रिपोर्ट करें; दुरुपयोग करने वाले मॉक के लिए संपर्क फ़ॉर्म में मॉक लिंक दें।

VPN क्या है

VPN टैब आपके iPhone/iPad का इंटरनेट ट्रैफ़िक ऐप के अपने गेटवे से भेजता है; वेबसाइटों को आपके पते की जगह गेटवे का पता दिखता है। एक ही गेटवे (सर्वर या लोकेशन चुनना नहीं) और उचित-उपयोग की दैनिक सीमा है। यह आपको गुमनाम नहीं बनाता। क्या प्रोसेस होता है और क्या दर्ज नहीं होता, यह गोपनीयता नीति में ठीक-ठीक है।

VPN कनेक्ट करना

  1. VPN टैब में "कनेक्ट करें" टैप करें; पहली बार सूचना पढ़कर "सहमत हों और कनेक्ट करें" टैप करें। "अभी नहीं" से कुछ शुरू नहीं होता, ऐप चलता रहता है।
  2. पहली बार iOS VPN कॉन्फ़िगरेशन जोड़ने की अनुमति माँगता है: "अनुमति दें" टैप करें और Face ID, Touch ID या पासकोड से पुष्टि करें।
  3. ऐप "कनेक्ट हो गया" तभी दिखाता है जब जाँच ले कि ट्रैफ़िक सचमुच गेटवे से गुज़र रहा है। "गेटवे ऑनलाइन है" का मतलब सिर्फ़ इतना कि गेटवे तक पहुँचा जा सकता है, कनेक्शन का प्रमाण नहीं।

डिस्कनेक्ट और हटाना

  • डिस्कनेक्ट: VPN टैब में "डिस्कनेक्ट करें", या iOS सेटिंग्स में VPN स्विच बंद करें।
  • कॉन्फ़िगरेशन हटाना: ऐप सेटिंग्स में VPN के अंतर्गत "VPN कॉन्फ़िगरेशन हटाएँ", या iOS सेटिंग्स → सामान्य → VPN और डिवाइस प्रबंधन → VPN में ऐप के VPN की जानकारी बटन → "VPN हटाएँ"। ऐप हटाने पर भी हट जाता है। वहीं "सहमति वापस लें" VPN डिस्कनेक्ट करता है और अगले कनेक्शन से पहले फिर पूछता है।

VPN की सीमाएँ

  • सिर्फ़ IPv4 (VPN चालू रहने पर IPv6 ब्लॉक; सिर्फ़ IPv6 वाली सेवा डिस्कनेक्ट करने तक लोड नहीं होगी) और सिर्फ़ TCP/UDP।
  • गति सीमा; दैनिक सीमा ख़त्म होने पर गेटवे सेशन ख़त्म करता है और अगले UTC दिन तक नए अस्वीकार करता है।
  • प्रति इंस्टॉलेशन एक कनेक्शन: नया पुराने को ख़त्म करता है, और सेशन बहुत बार शुरू करना सीमित है।
  • पोर्ट 25 (SMTP) का आउटगोइंग ईमेल ब्लॉक; पोर्ट 587/465 प्रभावित नहीं।
  • निजी और स्थानीय पते गेटवे से नहीं खुलते।
  • सेशन अधिकतम 12 घंटे चलता है; डिस्कनेक्ट, गेटवे के बंद करने या सीमा ख़त्म होने पर जल्दी ख़त्म होता है। VPN अपने आप बार-बार दोबारा कनेक्ट नहीं होता।
  • iOS में एक समय में एक ही VPN: पहले बाकी बंद करें। कुछ साइटें साझा पते ब्लॉक करती हैं, VPN से शायद न चलें।

VPN कनेक्ट न हो तो

  • कनेक्शन तैयार किया जा रहा है (permission): iOS ने अनुमति नहीं दी। फिर कनेक्ट करके अनुमति दें; प्रबंधित डिवाइस पर एडमिन से पूछें; iOS सेटिंग्स में VPN बंद हो तो चालू करें।
  • गेटवे खोजा जा रहा है (resolve) या "गेटवे तक पहुँचा नहीं जा सका": ऑनलाइन होना और ऐप का डोमेन ब्लॉक न होना जाँचें; दूसरा नेटवर्क आज़माएँ।
  • टनल शुरू हो रहा है (provider) या नेटवर्क सेट किया जा रहा है (settings): ऐप फिर खोलें, डिवाइस रीस्टार्ट करें, दूसरा VPN बंद करें; फिर भी विफल हो तो कॉन्फ़िगरेशन हटाकर फिर कनेक्ट करें।
  • गेटवे से संपर्क किया जा रहा है (handshake): गेटवे के पते तक पहुँचे, पर जवाब नहीं मिला: गेटवे व्यस्त या बंद, नेटवर्क रोक रहा, या सेशन बहुत बार शुरू किए (रुकें)।
  • कनेक्शन जाँचा जा रहा है (traffic): डेटा नहीं गुज़रा या रुक गया: कमज़ोर कनेक्शन, दैनिक सीमा ख़त्म, या नए सेशन ने जगह ली। डिस्कनेक्ट करके रुकें, फिर कनेक्ट करें।

डेटा हटाना

  • कॉन्ट्रैक्ट को More actions मेनू से हटाएँ (उसका होस्टेड मॉक ऑफ़लाइन होता है)। Settings, Your data, Delete all data इस डिवाइस से सभी कॉन्ट्रैक्ट, वर्ज़न, टास्क और लंबित शेयर किए दस्तावेज़ हटाता है और ऑनलाइन होने पर होस्टेड मॉक ऑफ़लाइन करता है; ऐप हटाने पर भी डेटा हट जाता है।
  • सर्वर पर रखा डेटा हटाने के लिए इस पेज का संपर्क फ़ॉर्म इस्तेमाल करें, मॉक लिंक या रिपोर्ट की तारीख़ और शब्द दें।
  • VPN देखी गई वेबसाइटों का हटाने योग्य रिकॉर्ड नहीं रखता; रोकने के लिए डिस्कनेक्ट करें और कॉन्फ़िगरेशन हटाएँ।

विजेट और ऑफ़लाइन

विजेट, Control Center, Siri/Shortcuts, Spotlight; Tasks बोर्ड पर Track rollout प्रगति Live Activity में दिखाता है। ऐप ऑफ़लाइन चलता है; होस्टेड मॉक, AI मदद, रिपोर्ट और VPN को इंटरनेट चाहिए।

संपर्क

इस पेज का संपर्क फ़ॉर्म इस्तेमाल करें: ऐप वर्ज़न (Settings, Version), डिवाइस, iOS वर्ज़न और समस्या के चरण बताएँ; पासवर्ड या गुप्त की न भेजें। VPN टैब में दिखा रुका चरण (permission आदि) और Wi-Fi/मोबाइल डेटा भी बताएँ; देखी गई वेबसाइटें न लिखें।

Македонски

Започнување

Бесплатна апликација за API договори со верзии на iPhone и iPad, со изборен VPN во табот VPN. Не е потребна сметка. Табот Studio има пример-договор „Bookshop API“; за шаблон, празен договор или увоз допрете New contract.

Компатибилност

Договор → Compatibility: изберете две верзии; промените се означуваат како breaking, risky или safe, со предложена семантичка верзија.

Извоз

Договор → Specs and exports: прегледајте, копирајте, споделете или зачувајте OpenAPI 3.1 (JSON/YAML), документ за преглед во Markdown или архива на договорот. Извозите го напуштаат уредот само при споделување или зачувување.

Увоз

New contract → Import from Files: документ OpenAPI 3.0/3.1 (JSON/YAML, до 5 MB) или архива на договор. Датотека, текст или HTTPS-врска од друга апликација чека во Shared documents до увоз или отфрлање.

Хостирани мокови

Договор → Mock endpoints → Publish mock: јавна врска со примери на одговори. Со Try a request повикувајте од апликацијата, изберете статус или доцнење до 3.000 ms; од други алатки статус се избира со X-Mock-Status или __status. До 10 активни мокови по инсталација. Секој со врската може да го повика мокот: не ставајте лични податоци или тајни во примерите. Unpublish веднаш ја исклучува врската; некористените мокови се бришат по 90 дена.

Помош од ВИ

Помошта од ВИ составува нацрт, објаснува промени, предлага примери и прегледува верзија. Изборна е и исклучена додека не допрете Agree and continue на екранот „Allow AI help?“; Not now не испраќа ништо. Со дозвола до API Contract Studio AI Gateway оди само потребниот текст, а OpenAI, OpenRouter и Google може да го обработуваат; детали има во политиката за приватност.

Исклучување: Settings → AI help → Withdraw permission; ништо повеќе не се испраќа, а испратеното не се враќа. Пријава: Report this result; за злоупотребен мок користете го формуларот за контакт со врската.

Што е VPN

Табот VPN го испраќа интернет-сообраќајот на iPhone/iPad преку сопствениот гејтвеј на апликацијата, па веб-местата ја гледаат адресата на гејтвејот, не вашата. Има еден гејтвеј (без избор на сервер или локација) и дневна граница за фер користење. Не ве прави анонимни. Политиката за приватност точно кажува што се обработува и што не се бележи.

Поврзување со VPN

  1. Допрете „Поврзи се“; првпат прочитајте го известувањето и прифатете го. Ако одбиете, ништо не започнува; апликацијата работи понатаму.
  2. Првпат iOS бара дозвола за VPN-конфигурација: допрете Allow и потврдете со Face ID, Touch ID или лозинка.
  3. „Поврзано“ се прикажува само откако апликацијата ќе провери дека сообраќајот минува низ гејтвејот. „Гејтвејот е онлајн“ значи само дека гејтвејот е достапен, не доказ за врска.

Исклучување и отстранување

  • Исклучување: „Прекини ја врската“ во табот VPN или прекинувачот за VPN во поставките на iOS.
  • Отстранување: поставки на апликацијата → VPN → „Отстрани ја VPN-конфигурацијата“, или iOS Settings, General, VPN & Device Management, VPN, Delete VPN. Бришењето на апликацијата ја отстранува. „Повлечи ја согласноста“ го прекинува VPN и пред следното поврзување бара согласност повторно.

Граници на VPN

  • Само IPv4 и само TCP/UDP: IPv6 е блокиран додека VPN е вклучен; услуга само преку IPv6 не се вчитува додека не се прекине врската.
  • Ограничена брзина; кога дневната граница ќе се искористи, гејтвејот ја завршува сесијата и одбива нови до следниот UTC-ден.
  • Една врска по инсталација (нова ја завршува старата); честите нови сесии се ограничени.
  • Порта 25 (SMTP) за појдовна е-пошта е блокирана; порти 587/465 не се засегнати.
  • До приватни и локални адреси не се стигнува преку гејтвејот.
  • Сесијата трае најмногу 12 часа; порано завршува при прекин, затворање од гејтвејот или искористена граница. VPN не се поврзува повторно сам.
  • iOS дозволува еден VPN во исто време: исклучете ги другите.

VPN не се поврзува

  • Се подготвува врската (permission): iOS не даде дозвола. Допрете „Поврзи се“ и дозволете; на управуван уред прашајте го администраторот.
  • Се бара гејтвејот (resolve) или „Не можеше да се стигне до гејтвејот“: проверете интернет и дали мрежа го блокира доменот на апликацијата; пробајте друга мрежа.
  • Се стартува тунелот (provider) или Се поставува мрежата (settings): отворете ја апликацијата пак, рестартирајте го уредот; ако не успее, отстранете ја конфигурацијата и поврзете се.
  • Се воспоставува контакт со гејтвејот (handshake): адресата е достигната, нема одговор: гејтвејот е зафатен или исклучен, мрежата блокира или сесиите се започнуваат пречесто (почекајте).
  • Се проверува врската (traffic): нема податоци или запрело: слаба врска, искористена дневна граница или понова сесија. Прекинете, почекајте и поврзете се пак.

Бришење податоци

  • Договор: More actions → бришење (мокот се исклучува). Settings, Your data, Delete all data брише од уредот договори, верзии, задачи и документи што чекаат и ги исклучува моковите ако сте на интернет; со отстранување на апликацијата податоците се бришат од уредот.
  • За податоци на нашиот сервер користете го формуларот за контакт со врската до мокот или датумот и текстот на пријавата.
  • VPN не чува записи за посетени веб-места што би можеле да се избришат; за запирање, прекинете ја врската и отстранете ја конфигурацијата.

Виџети и без интернет

На таблата Tasks, Track rollout покажува напредок како Live Activity (и виџети, Siri/Кратенки, Spotlight). Апликацијата работи без интернет; за мокови, помош од ВИ, пријави и VPN треба интернет.

Контакт

Користете го формуларот за контакт на оваа страница: верзија на апликацијата (Settings, Version), уред, верзија на iOS и чекори до проблемот; без лозинки или тајни клучеви. За VPN и чекорот каде запре (permission и др.), Wi-Fi или мобилни податоци; без посетени веб-места.

ગુજરાતી

શરૂઆત

આ iPhone અને iPad પર વર્ઝન ધરાવતા API કોન્ટ્રાક્ટ ડિઝાઇન કરવા માટેની મફત ઍપ છે; VPN ટૅબમાં વૈકલ્પિક VPN છે. એકાઉન્ટની જરૂર નથી. Studio ટૅબમાં નમૂના કોન્ટ્રાક્ટ "Bookshop API" છે; ટેમ્પ્લેટ, ખાલી કોન્ટ્રાક્ટ કે ઇમ્પોર્ટથી શરૂ કરવા New contract પર ટૅપ કરો.

સુસંગતતા

કોન્ટ્રાક્ટ → Compatibility: બે વર્ઝન પસંદ કરો; ફેરફાર breaking, risky કે safe માં વહેંચાય છે, સાથે સૂચવેલું semantic version.

એક્સપોર્ટ

કોન્ટ્રાક્ટ → Specs and exports: OpenAPI 3.1 (JSON/YAML), Markdown સમીક્ષા દસ્તાવેજ કે કોન્ટ્રાક્ટ આર્કાઇવ જુઓ, કૉપિ, શેર કે સેવ કરો; એક્સપોર્ટ શેર કે સેવ કરો ત્યારે જ ડિવાઇસની બહાર જાય છે.

ઇમ્પોર્ટ

New contract → Import from Files: OpenAPI 3.0/3.1 દસ્તાવેજ (JSON/YAML, 5 MB સુધી) કે કોન્ટ્રાક્ટ આર્કાઇવ. બીજી ઍપમાંથી ફાઇલ, ટેક્સ્ટ કે HTTPS લિંક શેર કરો; તે ઇમ્પોર્ટ કે રદ ન કરો ત્યાં સુધી Shared documentsમાં રહે છે.

હોસ્ટેડ મોક

કોન્ટ્રાક્ટ → Mock endpoints → Publish mock: ઉદાહરણ જવાબ આપતી જાહેર લિંક. Try a request થી ઍપમાં કૉલ કરો, સ્ટેટસ બદલો કે 3,000 ms સુધીનો વિલંબ ઉમેરો; અન્ય સાધનોથી X-Mock-Status હેડર કે __status query પેરામીટરથી સ્ટેટસ પસંદ કરો. ઇન્સ્ટોલેશન દીઠ 10 સુધી સક્રિય મોક. લિંક ધરાવતું કોઈ પણ કૉલ કરી શકે છે: ઉદાહરણોમાં અંગત ડેટા કે ગુપ્ત માહિતી ન મૂકો. Unpublish કરતાં લિંક તરત બંધ; અનુપયોગી મોક 90 દિવસ પછી દૂર થાય છે.

AI મદદ

AI મદદ મુસદ્દો, ફેરફારોની સમજૂતી, ઉદાહરણ payload અને વર્ઝનની સમીક્ષા આપે છે. તે વૈકલ્પિક છે, "Allow AI help?" સ્ક્રીન પર Agree and continue પર ટૅપ ન કરો ત્યાં સુધી બંધ; Not now કંઈ મોકલતું નથી. પરવાનગી પછી પસંદ કરેલી ક્રિયા માટે જરૂરી ટેક્સ્ટ જ API Contract Studio AI Gatewayને મોકલાય છે, જેના પર OpenAI, OpenRouter અને Google પ્રક્રિયા કરી શકે છે; વિગતો ગોપનીયતા નીતિમાં છે. પરિણામો સૂચનો છે, લાગુ કરતાં પહેલાં તપાસો. દૈનિક મર્યાદા Copilot ટૅબમાં.

Settings → AI help → Withdraw permission થી બંધ કરો: પછી કંઈ મોકલાતું નથી, મોકલેલો ટેક્સ્ટ પાછો લઈ શકાતો નથી; પછીથી ફરી પરવાનગી આપી શકો છો. પરિણામ નીચે Report this result થી જાણ કરો; દુરુપયોગ કરતા મોક માટે સંપર્ક ફોર્મમાં મોક લિંક આપો.

VPN શું છે

VPN ટૅબ તમારા iPhone/iPad નો ઇન્ટરનેટ ટ્રાફિક ઍપના પોતાના ગેટવે મારફતે મોકલે છે; વેબસાઇટ્સને તમારું નહીં, ગેટવેનું સરનામું દેખાય છે. એક જ ગેટવે (સર્વર કે સ્થાન પસંદ કરી શકાતું નથી) અને વાજબી ઉપયોગની દૈનિક મર્યાદા છે. તે તમને અનામી બનાવતું નથી. શું પ્રક્રિયા થાય છે અને શું નોંધાતું નથી તે ગોપનીયતા નીતિમાં ચોક્કસ જણાવ્યું છે.

VPN કનેક્ટ કરવું

  1. VPN ટૅબમાં "કનેક્ટ કરો" પર ટૅપ કરો; પહેલી વાર સૂચના વાંચીને "સંમત થાઓ અને કનેક્ટ કરો" પર ટૅપ કરો. "હમણાં નહીં" પર કંઈ શરૂ થતું નથી, ઍપ ચાલતી રહે છે.
  2. પહેલી વાર iOS VPN કન્ફિગરેશન ઉમેરવાની પરવાનગી માગે છે: Allow પર ટૅપ કરો અને Face ID, Touch ID કે પાસકોડથી પુષ્ટિ કરો.
  3. તમારો ટ્રાફિક ખરેખર ગેટવેમાંથી પસાર થાય છે તે તપાસ્યા પછી જ ઍપ "કનેક્ટ થયું" બતાવે છે. "ગેટવે ઓનલાઇન છે" નો અર્થ ફક્ત એટલો કે ગેટવે સુધી પહોંચી શકાય છે, કનેક્શનનો પુરાવો નથી.

ડિસ્કનેક્ટ અને દૂર કરવું

  • ડિસ્કનેક્ટ: VPN ટૅબમાં "ડિસ્કનેક્ટ કરો", અથવા iOS સેટિંગ્સમાં VPN સ્વિચ બંધ કરો.
  • કન્ફિગરેશન દૂર કરવું: ઍપ સેટિંગ્સમાં VPN હેઠળ "VPN કન્ફિગરેશન દૂર કરો", અથવા iOS સેટિંગ્સ → General → VPN & Device Management → VPN માં ઍપના VPN ની બાજુનું માહિતી બટન → Delete VPN. ઍપ ડિલીટ કરવાથી પણ દૂર થાય છે. ત્યાં જ "સંમતિ પાછી ખેંચો" VPN ને ડિસ્કનેક્ટ કરે છે અને આગલા કનેક્શન પહેલાં ફરી પૂછે છે.

VPN ની મર્યાદાઓ

  • ફક્ત IPv4 (VPN ચાલુ હોય ત્યારે IPv6 બ્લૉક; ફક્ત IPv6 સેવા ડિસ્કનેક્ટ કરો ત્યાં સુધી લોડ નહીં થાય) અને ફક્ત TCP/UDP.
  • ઝડપ મર્યાદા; દૈનિક મર્યાદા પૂરી થતાં ગેટવે સેશન પૂરું કરે છે અને આગલા UTC દિવસ સુધી નવાં નકારે છે.
  • ઇન્સ્ટોલેશન દીઠ એક કનેક્શન: નવું જૂનું પૂરું કરે છે; સેશન ખૂબ વાર શરૂ કરવા પર મર્યાદા.
  • પોર્ટ 25 (SMTP) પરનો આઉટગોઇંગ ઇમેઇલ બ્લૉક; પોર્ટ 587/465 પ્રભાવિત નથી.
  • ખાનગી અને સ્થાનિક સરનામાં ગેટવેથી ખૂલતાં નથી.
  • સેશન વધુમાં વધુ 12 કલાક; ડિસ્કનેક્ટ, ગેટવે બંધ કરે કે મર્યાદા પૂરી થાય તો વહેલું પૂરું. VPN જાતે વારંવાર ફરી કનેક્ટ થતું નથી.
  • iOS માં એક સમયે એક જ VPN: પહેલાં બીજાં બંધ કરો. કેટલીક સાઇટ્સ વહેંચાયેલાં સરનામાં બ્લૉક કરે છે (VPN થી ન ચાલે).

VPN કનેક્ટ ન થાય તો

  • કનેક્શન તૈયાર થઈ રહ્યું છે (permission): iOS એ પરવાનગી આપી નથી. ફરી કનેક્ટ કરીને પરવાનગી આપો; સંચાલિત ડિવાઇસ પર એડમિનને પૂછો; iOS સેટિંગ્સમાં VPN બંધ હોય તો ચાલુ કરો.
  • ગેટવે શોધાઈ રહ્યો છે (resolve) કે "ગેટવે સુધી પહોંચી શકાયું નહીં": ઑનલાઇન હોવાનું અને ઍપનું ડોમેન બ્લૉક ન હોવાનું તપાસો; બીજું નેટવર્ક અજમાવો.
  • ટનલ શરૂ થઈ રહી છે (provider) કે નેટવર્ક સેટ થઈ રહ્યું છે (settings): ઍપ ફરી ખોલો, ડિવાઇસ રીસ્ટાર્ટ કરો, બીજું VPN બંધ કરો; છતાં નિષ્ફળ રહે તો કન્ફિગરેશન દૂર કરીને ફરી કનેક્ટ કરો.
  • ગેટવે સાથે સંપર્ક થઈ રહ્યો છે (handshake): ગેટવેના સરનામા સુધી પહોંચ્યા, જવાબ નહીં: ગેટવે વ્યસ્ત કે બંધ, નેટવર્ક રોકે છે, અથવા સેશન ખૂબ વાર શરૂ કર્યાં (થોભો).
  • કનેક્શન તપાસાઈ રહ્યું છે (traffic): ડેટા પસાર થયો નહીં કે અટકી ગયું: નબળું કનેક્શન, દૈનિક મર્યાદા પૂરી, અથવા નવા સેશને જગ્યા લીધી. ડિસ્કનેક્ટ કરીને થોભો, પછી કનેક્ટ કરો.

ડેટા ડિલીટ

  • કોન્ટ્રાક્ટને More actions મેનૂમાંથી ડિલીટ કરો (તેનો હોસ્ટેડ મોક ઑફલાઇન થાય છે). Settings, Your data, Delete all data આ ડિવાઇસ પરથી બધા કોન્ટ્રાક્ટ, વર્ઝન, કામ અને બાકી શેર કરેલા દસ્તાવેજ ડિલીટ કરે છે અને ઑનલાઇન હો ત્યારે હોસ્ટેડ મોક ઑફલાઇન કરે છે; ઍપ દૂર કરવાથી પણ ડેટા ડિલીટ થાય છે.
  • સર્વર પરનો ડેટા ડિલીટ કરવા આ પેજ પરનું સંપર્ક ફોર્મ વાપરો; મોક લિંક કે રિપોર્ટની તારીખ અને શબ્દો આપો.
  • VPN મુલાકાત લીધેલી વેબસાઇટ્સની ડિલીટ કરી શકાય તેવી નોંધ રાખતું નથી; રોકવા ડિસ્કનેક્ટ કરો અને કન્ફિગરેશન દૂર કરો.

વિજેટ અને ઑફલાઇન

વિજેટ, Control Center, Siri/Shortcuts, Spotlight; Tasks બોર્ડ પર Track rollout પ્રગતિ Live Activity માં બતાવે છે. ઍપ ઑફલાઇન ચાલે છે; હોસ્ટેડ મોક, AI મદદ, રિપોર્ટ અને VPN ને ઇન્ટરનેટ જોઈએ.

સંપર્ક

આ પેજ પરનું સંપર્ક ફોર્મ વાપરો: ઍપ વર્ઝન (Settings, Version), ડિવાઇસ, iOS વર્ઝન અને સમસ્યાનાં પગલાં જણાવો; પાસવર્ડ કે ગુપ્ત કી ન મોકલો. VPN માં અટકેલો તબક્કો (permission વગેરે) અને Wi-Fi કે મોબાઇલ ડેટા જણાવો; મુલાકાત લીધેલી વેબસાઇટ્સ ન લખો.

Send us a message

We use what you send only to answer you — see the privacy policy.