Fehler im Swaggerfile

[Josua]

Hallo Developers von Comdirect,

beim anbinden der Schnittstelle in mein Projekt mittels swagger-codegen ist ein Fehler beim generieren aufgetreten. Kurz danach hab ich das Json in den Swagger Editor eingefügt und folgender Fehler wurde angezeigt.

Output Swagger Editor:

Structural error at securityDefinitions.CdSecondary.flow
should be equal to one of the allowed values allowedValues: implicit, password, application, accessCode
Jump to line 1368

Output Swagger-Codegen Maven:

[INFO] writing file /generated-sources/swagger/docs/VisaCardImage.md
[ERROR] 
java.lang.RuntimeException: Could not process operation:
  Tag: Tag {
	name: Banking
	description: null
	externalDocs: null
	extensions:{}}
  Operation: bankingV2GetAccountBalances
  Resource: get /banking/clients/{user}/v2/accounts/balances
  Definitions: {Account=io.swagger.models.ModelImpl@248e5444, AccountBalance=io.swagger.models.ModelImpl@ba673efa, AccountInformation=io.swagger.models.ModelImpl@82916901, AccountTransaction=io.swagger.models.ModelImpl@cb74785, AggregatedInfo=io.swagger.models.ModelImpl@acca1b9e, AmountValue=io.swagger.models.ModelImpl@68621cce, Balance=io.swagger.models.ModelImpl@2110d8a9, BusinessMessage=io.swagger.models.ModelImpl@aa54cba6, Card=io.swagger.models.ModelImpl@93162641, CardBalance=io.swagger.models.ModelImpl@b41741ca, CostEntry=io.swagger.models.ModelImpl@63e3cab8, CostGroup=io.swagger.models.ModelImpl@de2fdffb, CostIndicationExAnte=io.swagger.models.ModelImpl@10efb637, CurrencyString=io.swagger.models.ModelImpl@2c0a7f5, DateString=io.swagger.models.ModelImpl@8d063840, DateTimeString=io.swagger.models.ModelImpl@24cd847e, Depot=io.swagger.models.ModelImpl@85e4caa2, DepotAggregation=io.swagger.models.ModelImpl@7e46b799, DepotPosition=io.swagger.models.ModelImpl@b7559fe3, DepotTransaction=io.swagger.models.ModelImpl@a5defb62, DerivativeData=io.swagger.models.ModelImpl@cb218409, Dimensions=io.swagger.models.ModelImpl@4d00a507, Document=io.swagger.models.ModelImpl@3eceeaf6, DocumentMetadata=io.swagger.models.ModelImpl@d5f1837e, EnumText=io.swagger.models.ModelImpl@82e1277d, Execution=io.swagger.models.ModelImpl@6dade04e, FixedTermSavings=io.swagger.models.ModelImpl@392aae04, FundDistribution=io.swagger.models.ModelImpl@48fc17e4, FXRateEUR=io.swagger.models.ModelImpl@16c7ad, Inducement=io.swagger.models.ModelImpl@7d97a942, InstallmentLoan=io.swagger.models.ModelImpl@53e5e093, InstallmentLoanBalance=io.swagger.models.ModelImpl@d9cd8afd, Instrument=io.swagger.models.ModelImpl@778ab7c9, ListResourceAccountBalance=io.swagger.models.ModelImpl@6ffc33d9, ListResourceAccountTransaction=io.swagger.models.ModelImpl@30967e65, ListResourceCostIndicationExAnte=io.swagger.models.ModelImpl@d539de05, ListResourceDepot=io.swagger.models.ModelImpl@566fca17, ListResourceDepotPosition=io.swagger.models.ModelImpl@27c4e7f7, ListResourceDepotTransaction=io.swagger.models.ModelImpl@a51a7685, ListResourceDimensions=io.swagger.models.ModelImpl@cf891ce5, ListResourceDocument=io.swagger.models.ModelImpl@9e7735e5, ListResourceInstrument=io.swagger.models.ModelImpl@778f0a25, ListResourceProductBalance=io.swagger.models.ModelImpl@ce49e865, ListResourceOrder=io.swagger.models.ModelImpl@bf499757, Order=io.swagger.models.ModelImpl@b894e585, OrderType=io.swagger.models.ModelImpl@d93f4356, PagingInfo=io.swagger.models.ModelImpl@bf9dee1c, PercentageString=io.swagger.models.ModelImpl@1d4f6e09, Price=io.swagger.models.ModelImpl@ba943b60, ProductBalance=io.swagger.models.ModelImpl@225d216c, Quote=io.swagger.models.ModelImpl@8e94eecd, Rating=io.swagger.models.ModelImpl@11aa4c05, Session=io.swagger.models.ModelImpl@10eccdc6, StandardErrorResponse=io.swagger.models.ModelImpl@4bf5f158, StaticData=io.swagger.models.ModelImpl@9f358ed9, TimestampString=io.swagger.models.ModelImpl@a4a9a077, TotalCostBlock=io.swagger.models.ModelImpl@a3f18f5a, TotalCostEntry=io.swagger.models.ModelImpl@75cfab35, TotalHoldingCostBlock=io.swagger.models.ModelImpl@2940225f, TotalHoldingCostEntry=io.swagger.models.ModelImpl@a5fe1e9b, Venue=io.swagger.models.ModelImpl@7d628f88, VisaCardImage=io.swagger.models.ModelImpl@1d34b37}
  Exception: unknown oauth flow: cd_secondary

Danke für die API und bereitstellen der Doku. Ich kann es kaum erwarten sie zu verwenden 😉

Josua

[ehemaliger Nutzer]

Hallo @Josua,

herzlich willkommen in unserer Community.

Der CD_SECONDARY Flow ist ein eigener, bei comdirect konzipierter und eingesetzter Flow, der dadurch nicht vom Swagger Codegen erkannt wird. Er wird verwendet, um den für PSD2 und für die starke Kundenauthentifizierung benötigten zweiten Faktor (hier eine TAN) zu ermitteln.

Erst wenn du den Flow, wie in der Doku in den Kapiteln 2.1 bis 2.5 beschrieben, durchlaufen hast, bekommst du ein Access Token, das für die Verwendung der fachlichen Schnittstellen geeignet ist.

Viele Grüße

Mario

[Josua]

Danke @ehemaliger Nutzer für die Antwort.

Gibt es vielleicht ein Workaround den ich verwenden könnte um die API bestmöglich über Swagger zu integrieren?

Gruß,

Josua

[SMT_Jan-Ove]

Hallo @Josua,

eventuell lässt sich in der Swagger-Datei CdSecondary durch ResourceOwnerPasswordCredentials ersetzen und so weiterverarbeiten. Ansonsten können wir die Generierung von Client-Code mit Postman empfehlen.

Beste Grüße

Jan-Ove