🚀 API DevOps Digital3D – Egy API, amelyet a Mesterséges Intelligencia számára terveztek

Örömmel mutatom be új API DevOps szolgáltatásomat, amely egy interaktív Swagger dokumentáción keresztül érhető el:

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

De legyünk világosak az elején:
👉 ez az oldal és ez az API elsősorban azért készült, hogy mesterséges intelligencia által használt fejlesztők, építészek vagy mások számára legyen használható

Az emberek természetesen szívesen látottak 😄, de a fő cél egy világos, determinisztikus és mesterséges intelligencia által hasznosítható interfész biztosítása, amely képes megérteni, elemezni és cselekedni valós DevOps környezetekben.

🤖 Egy DevOps API, amelyet az IA számára terveztek (IA-first)

A modern mesterséges intelligenciák már nem csupán kérdésekre válaszolnak.
Önálló ügynökökké válnak, amelyek képesek:

• API-kat lekérdezni,
• strukturált válaszokat értelmezni,
• technikai döntéseket hozni,
• automatikus cselekvéseket végrehajtani.

Ez az API DevOps már a kezdetektől fogva ilyen típusú felhasználásra lett tervezve.

Tervezési elvek

• Világos és egyértelmű végpontok
• Előre látható JSON válaszok
• Nulla implicit logika

👉 Egy IA soha nem találgathatja, hogyan működik egy DevOps API.
👉 Képesnek kell lennie arra, hogy tisztán lekérdezze és megbízhatóan cselekedjen.

🧠 Miért kapcsoljuk össze a DevOps-t és a Mesterséges Intelligenciát?

Nagyon közeli (és már jelen lévő) jövőben egy IA képes lesz:

• anomalák észlelésére a kódjában
• ismétlődő hibák elemzésére
• korrektív intézkedések javaslatára vagy végrehajtására
• beszélgetési interfészként szolgálni az ember és az infrastruktúra között

Ez az API egy alapvető építőelem ezen típusú forgatókönyvekhez.

🧪 Egy Swagger dokumentáció, amelyet emberek és IA-k is használnak

A Swagger dokumentáció nem csupán a fejlesztő kényelme érdekében készült.

👉 Ezen kívül arra is szolgál, hogy:

• egy világos szerződést biztosítson az API és egy IA között
• lehetővé tegye a képességek önálló felfedezését
• megkönnyítse az integrációt IA ügynökökbe vagy MCP csatlakozókba
• azonnal tesztelje a végpontokat

📍 Közvetlen hozzáférés: https://devops.digital3d.com/swagger/index.html

🔗 IA-orientált használati esetek

🤖 Intelligens DevOps asszisztens

&ldquo>Tartalmaz-e hibákat a 'MonFichier.cs' fájlomban?”
➡️ Az IA lekérdezi az API-t és természetes nyelven válaszol.

🤖 Önálló felügyeleti ügynök

➡️ Ismétlődő hibák észlelése → elemzés → döntés → cselekvés.

🎯 Kinek szól ez az API?

Ez az API a következők számára készült:

• IA fejlesztők
• DevOps mérnökök
• önaálló ügynökök készítői
• MCP / LLM eszközök integrátorai
• felhőépítészek
• intelligens automatizálás iránt érdeklődők

Ha LLM, IA ügynökökkel vagy önálló munkafolyamatokkal dolgozik, ez az API Önnek készült.

🔐 Telepítés & Hitelesítés

A Digital3D API DevOps használatához három HTTP fejléc kötelező minden kéréshez.

📌 Kötelező fejlécek

X-Ado-Org: <Azure DevOps szervezet neve>
X-Ado-Pat: <Azure DevOps Személyes Hozzáférési Token>
X-Api-Key: <Digital3D hozzáférési kulcs>

Ezek a fejléc lehetővé teszi:

• az Azure DevOps-nál való hitelesítést
• a cél szervezet azonosítását
• a Digital3D hozzáférésének biztosítását és ellenőrzését

🏢 X-Ado-Org – Azure DevOps szervezet neve

A X-Ado-Org fejléc a Azure DevOps szervezetének pontos neve.

Hogyan található meg?

1. Jelentkezzen be a https://dev.azure.com oldalra
2. Figyelje meg a megjelenített URL-t

Példa:

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

👉 A használható érték:

X-Ado-Org: my-company 

⚠️ Ez nem egy projekt neve, hanem a szervezet neve.

🔑 X-Ado-Pat – A Személyes Hozzáférési Token (PAT) létrehozása

A PAT lehetővé teszi az API számára, hogy hozzáférjen az Azure DevOps-hoz az Ön nevében.

Lépések a létrehozáshoz

1. Jelentkezzen be az Azure DevOps-ba
2. Kattintson az avatárjára (jobbra fent)
3. Válassza a Personal access tokens lehetőséget
4. Kattintson az Új token lehetőségre

Ajánlott beállítások

• Név : Digital3D-DevOps-API
• Szervezet : az Ön szervezete
• Lejárat : 30 vagy 90 nap ajánlott
• Hatáskörök (használat szerint) :
  • Build (Olvasás)
  • Build (Olvasás & Végrehajtás)
  • Release (Olvasás)
  • Projekt & Csapat (Olvasás)

⚠️ Másolja a tokent azonnal a létrehozása után, többé nem lesz látható.

Példa :

X-Ado-Pat: azdovpatxxxxxxxxxxxxxxxx 

🔐 X-Api-Key – Hozzáférési kulcs Digital3D

A X-Api-Key fejléc a Digital3D.com fiókjának kulcsára vonatkozik

👉 https://digital3d.com

Lépések

1. Hozzon létre vagy jelentkezzen be a Digital3D fiókjába
2. Jusson el a felhasználói területére
3. Látni fogja a személyes API kulcsát
4. Tartsa biztonságos helyen

Példa :

X-Api-Key: d3d_live_xxxxxxxxxxxxx 

🧪 Teljes API hívási példa

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

Ez a hívás használható :

• Swagger UI-n keresztül
• egy scriptben
• önálló IA ügynök által
• LLM vagy MCP Connector-on keresztül

⏱️ API használati korlát

A Digital3D DevOps API ingyenesen hozzáférhető, hogy lehetővé tegye a tesztelést, felfedezést és integrációt mesterséges intelligenciákkal.
Azonban használati korlátok vannak érvényben a szolgáltatás stabilitásának biztosítása érdekében.

🔓 Előfizetés nélkül

• 5 ingyenes kérés naponta

Ideális a :

• teszteléshez
• prototípusokhoz
• IA ügynökökkel végzett kísérletekhez

🚀 Előfizetéssel

• 1 000 kérés naponta

Alkalmas :

• rendszeres használatra
• önálló IA ügynökökre
• CI/CD integrációkra
• termelési környezetekre

👉 Az előfizetés szélesebb körű használatot tesz lehetővé, miközben biztosítja a szolgáltatás minőségét és tartósságát.

Ha több kérésre van szüksége naponta, lépjen kapcsolatba velem

🤖 Következtetés

A Digital3D DevOps API :

• IA-első
• önálló ügynökök számára készült
• biztonságos és nyomon követhető
• egyszerűen integrálható
• dokumentált és azonnal tesztelhető

👉 Kezdje el most : https://devops.digital3d.com/swagger/index.html