Որտե՞ղ է համակարգի կառուցվածքային կառուցվածքում API-ի փաստաթղթերը, որոնք համապատասխանում են մաքուր ճարտարապետության սկզբունքներին։

Таза ճարտարապետության սկզբունքների համաձայն, API-ի փաստաթղթերը պետք է գտնվեն համակարգի սահմանային գոտում, այսինքն՝ ինտերֆեյսի ադապտերների շերտում կամ արտաքին ինտերֆեյսների մակարդակում (օրինակ՝ HTTP հենակետներ, gRPC ծառայություններ):

Սա կապված է այն բանի հետ, որ՝

• Ներքին շերտերը (բիզնես տրամաբանություն, դոմեն) չպետք է կախված լինեն API-ի իրականացման մանրամասներից:
• API-ի փաստաթղթերը նկարագրում են արտաքին աշխարհի հետ փոխազդեցության պայմանագրերը և պետք է արտացոլեն հենց այդ ինտերֆեյսերը:

Անհրաժեշտ է, որ փաստաթուղթը սովորաբար գտնվի այն կոդի կողքին, որը իրականացնում է ադապտերները և ինտերֆեյսները, որոնք կապում են ներքին տրամաբանությունը արտաքին հաճախորդների հետ:

Օրինակ, Go նախագծում դա կարող է լինել HTTP հենակետներով և համապատասխան swagger/openapi սպեցիֆիկացիաներով ֆայլային թղթապանակ։