🚀 API DevOps Digital3D – API navržená pro umělou inteligenci

Jsem velmi rád, že vám mohu představit moji novou službu API DevOps, přístupnou prostřednictvím interaktivní dokumentace Swagger:

👉 https://devops.digital3d.com/swagger/index.html

Ale buďme jasní hned na začátku:
👉 tato stránka a tato API byly především navrženy pro použití umělou inteligencí pro vývojáře, architekty nebo jiné

Lidé jsou samozřejmě vítáni 😄, ale hlavním cílem je poskytnout jasné, deterministické a využitelné rozhraní pro AI agenty, kteří jsou schopni porozumět, analyzovat a jednat v reálných DevOps prostředích.

🤖 API DevOps navržená pro AI (AI-first)

Moderní umělé inteligence se již neomezují pouze na odpovídání na otázky.
Stávají se autonomními agenty, kteří jsou schopni:

• dotazovat se na API,
• interpretovat strukturované odpovědi,
• učinit technická rozhodnutí,
• spouštět automatizované akce.

Tato API DevOps byla navržena od samého začátku pro tento typ použití.

Principy návrhu

• Jasné a jednoznačné koncové body
• Předvídatelné JSON odpovědi
• Žádná implicitní logika

👉 AI by nikdy neměla hádat, jak API DevOps funguje.
👉 Měla by být schopna se na něj správně dotazovat a jednat spolehlivě.

🧠 Proč spojit DevOps a umělou inteligenci?

V blízké budoucnosti (a již nyní) bude AI schopna:

• detekovat anomálie ve vašem kódu
• analyzovat opakující se chyby
• navrhovat nebo spouštět nápravná opatření
• sloužit jako konverzační rozhraní mezi člověkem a infrastrukturou

Tato API představuje základní kámen pro tento typ scénářů.

🧪 Dokumentace Swagger použitelná pro lidi i AI

Dokumentace Swagger není určena pouze pro pohodlí vývojáře.

👉 Slouží také k:

• poskytnutí jasné smlouvy mezi API a AI
• umožnění automatického objevování schopností
• usnadnění integrace do AI agentů nebo MCP konektorů
• okamžitému testování koncových bodů

📍 Přímý přístup: https://devops.digital3d.com/swagger/index.html

🔗 Případové použití orientované na AI

🤖 Inteligentní asistent DevOps

&ldquo>Obsahuje můj kód v souboru 'MonFichier.cs" chyby?”
➡️ AI se dotazuje na API a odpovídá v přirozeném jazyce.

🤖 Autonomní monitorovací agent

➡️ Detekce opakovaných chyb → analýza → rozhodnutí → akce.

🎯 Komu je tato API určena?

Tato API je určena pro:

• vývojáře AI
• DevOps inženýry
• tvůrce autonomních agentů
• integrátory MCP / LLM nástrojů
• cloudové architekty
• nadšence do inteligentní automatizace

Pokud pracujete s LLM, AI agenty nebo autonomními pracovními postupy, tato API je určena pro vás.

🔐 Instalace & Autentizace

Pro použití API DevOps Digital3D jsou tři HTTP hlavičky povinné pro každý požadavek.

📌 Povinné hlavičky

X-Ado-Org: <název organizace Azure DevOps>
X-Ado-Pat: <osobní přístupový token Azure DevOps>
X-Api-Key: <přístupový klíč Digital3D>

Tyto hlavičky umožňují:

• autentizaci vůči Azure DevOps
• identifikaci cílové organizace
• zajištění a kontrolu přístupu Digital3D

🏢 X-Ado-Org – Název organizace Azure DevOps

Hlavička X-Ado-Org odpovídá přesnému názvu vaší organizace Azure DevOps.

Jak ho najít?

1. Přihlaste se na https://dev.azure.com
2. Podívejte se na zobrazenou URL adresu

Příklad:

https://dev.azure.com/my-company/

👉 Hodnota, kterou je třeba použít, je:

X-Ado-Org: my-company 

⚠️ To není název projektu, ale název organizace.

🔑 X-Ado-Pat – Vytvoření osobního přístupového tokenu (PAT)

PAT umožňuje API přístup k Azure DevOps vaším jménem.

Kroky k vytvoření

1. Přihlaste se k Azure DevOps
2. Klikněte na svůj avatar (vpravo nahoře)
3. Vyberte Osobní přístupové tokeny
4. Klikněte na Nový token

Doporučená konfigurace

• Název : Digital3D-DevOps-API
• Organizace : vaše organizace
• Platnost : doporučeno 30 nebo 90 dní
• Rozsahy (podle použití) :
  • Build (Číst)
  • Build (Číst & Provést)
  • Release (Číst)
  • Projekt & Tým (Číst)

⚠️ Okamžitě zkopírujte token po jeho vytvoření, nebude již viditelný.

Příklad :

X-Ado-Pat: azdovpatxxxxxxxxxxxxxxxx 

🔐 X-Api-Key – Klíč pro přístup Digital3D

Hlavička X-Api-Key je specifická pro klíč vašeho účtu na Digital3D.com

👉 https://digital3d.com

Kroky

1. Vytvořte nebo se přihlaste ke svému účtu Digital3D
2. Přístup k vašemu uživatelskému prostoru
3. Uvidíte svůj osobní API klíč
4. Uložte ho na bezpečné místo

Příklad :

X-Api-Key: d3d_live_xxxxxxxxxxxxx 

🧪 Kompletní příklad API volání

GET /api/devops/projects
Host: devops.digital3d.com
X-Ado-Org: my-company
X-Ado-Pat: azdovpatxxxxxxxxxxxxxxxx
X-Api-Key: d3d_live_xxxxxxxxxxxxx 

Toto volání může být použito :

• přes Swagger UI
• v skriptu
• autonomním AI agentem
• přes LLM nebo MCP Connector

⏱️ Limity použití API

API DevOps Digital3D je přístupné zdarma, aby umožnilo testování, prozkoumávání a integraci s umělými inteligencemi.
Nicméně, limity použití jsou aplikovány pro zajištění stability služby.

🔓 Bez předplatného

• 5 bezplatných požadavků denně

Ideální pro :

• testy
• prototypy
• zkoušky s AI agenty

🚀 S předplatným

• 1 000 požadavků denně

Vhodné pro :

• pravidelné použití
• autonomní AI agenty
• CI/CD integrace
• produkční prostředí

👉 Předplatné umožňuje rozsáhlé použití při zajištění kvality a trvalosti služby.

Pokud si přejete více požadavků denně, kontaktujte mě

🤖 Závěr

API DevOps Digital3D je :

• IA-first
• navrženo pro autonomní agenty
• zajištěné a sledovatelné
• snadno integrovatelné
• dokumentované a okamžitě testovatelné

👉 Začněte hned teď : https://devops.digital3d.com/swagger/index.html