AnyPoint Studio kann nicht raml für APIKit laden, aber es sagt auch nichts mit der raml Datei falsch ist

Question

Ich identifiziere mich eine harte Zeit, warum die folgenden raml nicht geladen, wenn ich ein neues Projekt zu erstellen versuchen:

#%RAML 0.8 
title: MyMuleAPI API 
version: v1 
baseUri: https://localhost/api/v1 
securitySchemes: 
    - oauth_2_0: 
     description: | 
      MyCompany supports OAuth 2.0 for authenticating all API requests. 
     type: OAuth 2.0 
     describedBy: 
      headers: 
       Authorization: 
        description: | 
         Used to send a valid OAuth 2 access token. Do not use 
         with the "access_token" query string parameter. 
        type: string 
      queryParameters: 
       access_token: 
        description: | 
         Used to send a valid OAuth 2 access token. Do not use together with 
         the "Authorization" header 
        type: string 
      responses: 
       401: 
        description: | 
         Bad or expired token. This can happen if the user or Dropbox 
         revoked or expired an access token. To fix, you should re- 
         authenticate the user. 
       403: 
        description: | 
         Bad OAuth request (wrong consumer key, bad nonce, expired 
         timestamp...). Unfortunately, re-authenticating the user won't help here. 
     settings: 
      authorizationUri: https://login-dev.mycompany.com/connect/authorize 
      accessTokenUri: https://login-dev.mycompany.com//connect/token 
      authorizationGrants: [ token ] 

schemas: 
- Address: | 
    { 
     "id": "Address", 
     "title": "Address", 
     "Description": "the object for passing around addrss information", 
     "properties": { 
     "street": { 
      "description": "street including street number and appartment unit#", 
      "type": "string" 
     }, 
     "street2": { 
      "description": "second line of the address.", 
      "type": "string" 
     }, 
     "city": { 
      "description": "city name", 
      "type": "string" 
     }, 
     "state": { 
      "description": "a valid 2-letter US state abbreviation", 
      "type": "string" 
     }, 
     "zip": { 
      "description": "a 5-digit zip code", 
      "type": "string" 
     }  
     } 
    } 
- LoanApplication: | 
    { 
     "id": "LoanApplicationData", 
     "title": "LoanApplicationData", 
     "description": "loan application.", 
     "type": "object", 
     "properties": { 
     "loan_id": { 
      "description": "the Loans identifier for the loan request", 
      "type": "string" 
     }, 
     "FirstName": { 
      "description": "Applicant's first name.", 
      "type": "string" 
     }, 
     "LastName": { 
      "description": "Applicant's last name.", 
      "type": "string" 
     }, 
     "Address": { 
      "description": "applicat's address", 
      "type": "object" 
     }, 
     "Email": { 
      "description": "Applicant's email.", 
      "type": "string" 
     }, 
     "Phone": { 
      "description": "Applicant's phone, optional.", 
      "type": "string" 
     }, 
     "SSN": { 
      "description": "Applicant's SSN.", 
      "type": "string" 
     }, 
     "DateOfBirth": { 
      "description": "Applicant's date of birth.", 
      "type": "string" 
     }, 
     "YearlyIncome": { 
      "description": "Applicant's income.", 
      "type": "number" 
     } 
     } 
    } 
- LoanResponse: | 
    { 
     "id": "LoanResponse", 
     "title": "LoanResponse", 
     "Description": "the basic response telling you the current status of the loan", 
     "properties":{ 
     "loan_id": { 
      "description": "the Loan id to track this loans progress", 
      "type": "string" 
     }, 
     "status": { 
      "description": "a string describing the curernt state the loan is currently in", 
      "type": "string" 
     }, 
     "status_id": { 
      "description": "a numberic version of the status text", 
      "type": "integer" 
     } 
     } 
    } 
/application: 
    securedBy: [oauth_2_0] 
    /{loan_id}: 
    securedBy: [oauth_2_0] 
    uriParameters: 
     loan_id: 
     description: loan applicationData ID. 
     type: string 
     required: true 
     displayName: loan_id 
    put: 
     body: 
     application/json: 
      schema: LoanApplication 
     displayName: Application_Put 
     description: "Updates loan applicationData. 

      TODO: what do we allow to update." 
     responses: 
     200: 
      description: OK 
      body: 
      application/json: 
       schema: LoanApplication 
    get: 
     displayName: Application_Get 
     description: "retrieves application details" 
     responses: 
     200: 
      description: successful request 
      body: 
      application/json: 
       schema: LoanApplication 

    post: 
    body: 
     application/json: 
     schema: LoanApplication 
    displayName: Application_Post 
    description: Creates loan applicationData. 
    responses: 
     200: 
     description: OK 
     body: 
      application/json: 
      schema: LoanApplication 

wenn ich ein Projekt mit diesem raml zu sub aus der api zu starten versuchen, erhalte ich die folgende: aber wenn ich die raml entweder in der api Designer laden oder AnyPoint Validierungs kick off, es sagt

Was vermisse ich etwas?

Answer 1

Wenn ich die oben RAML im API Workbench öffnen, erhalte ich die folgende Warnung:

Wenn ich die Beschreibung wie folgt umschreiben:

put: 
    body: 
    application/json: 
     schema: LoanApplication 
    displayName: Application_Put 
    description: | 
    Updates loan applicationData. 

    TODO: what do we allow to update. 
    responses: 

dann die Warnung geht weg. Vielleicht wird das dein Problem lösen?