Erstellen eines Kontos als nicht authentifizierter Benutzer

Nicht authentifizierte Benutzer können Konten erstellen, indem sie an den Endpunkt /accounts POSTen.

• Eine vollständige Liste der für nicht authentifizierte Benutzer verfügbaren Endpunktzugriffe finden Sie in der Datei Unauthenticated.role.yaml im Verzeichnis Integration > roles.
• Weitere Informationen zum Erstellen von Konten mit dem Endpunkt /accounts finden Sie im Cloud-API-Geschäftsabläufe- und Konfigurationshandbuch.

Als Reaktion auf diesen POST sendet PolicyCenter ein Antwortobjekt. Der Textkörper der Antwort enthält Informationen zum neuen Konto, z. B. die Kontonummer des Kontos. Der Antwortheader enthält ein GW-Access-Token-Attribut, dessen Wert ein selbstsigniertes JWT ist. Die aufrufende Anwendung muss dieses JWT speichern, damit es in jeden nachfolgenden Aufruf aufgenommen werden kann, den der Aufrufer für das gerade erstellte Konto durchführen möchte.

Angenommen, ein nicht authentifizierter Benutzer möchte ein Konto erstellen. Für den Benutzer gelten die folgenden Informationen:

Die aufrufende Anwendung kann ein Konto für diesen Benutzer erstellen, indem sie einen POST /accounts mit den folgenden Anforderungs-Nutzdaten ausführt:

{
  "data": {
    "attributes": {
      "accountHolder": {
        "refid": "newperson"
      },
      "organizationType": {
        "code": "individual"
      },
      "preferredCoverageCurrency": {
        "code": "USD"
      },
      "preferredSettlementCurrency": {
        "code": "USD"
      },
      "primaryLocation": {
        "refid": "newloc"
      },
      "producerCodes": [
        {
          "id": "pc:6"
        }
      ]
    }
  },
  "included": {
    "AccountContact": [
      {
        "attributes": {
          "contactSubtype": "Person",
          "firstName": "Bill",
          "lastName": "Presley",
          "primaryAddress": {
            "addressLine1": "1234 Hillsdale Blvd",
            "city": "Foster City",
            "postalCode": "12345",
            "state": {
              "code": "CA"
            }
          }
        },
        "method": "post",
        "refid": "newperson",
        "uri": "/account/v1/accounts/this/contacts"
      }
    ],
    "AccountLocation": [
      {
        "attributes": {
          "locationCode": "0001",
          "locationName": "Location 0001",
          "nonSpecific": true,
          "postalCode": "12345",
          "state": {
            "code": "CA"
          }
        },
        "method": "post",
        "refid": "newloc",
        "uri": "/account/v1/accounts/this/locations"
      }
    ]
  }
}

PolicyCenter erstellt ein Konto, dem hier die Kontonummer 2558363138 zugewiesen wird. PolicyCenter sendet auch ein Antwortobjekt. Im Anforderungsheader ist das GW-Access-Token-Attribut auf Folgendes gesetzt:

eyJhbGciOiJIUzUxMiIsImtpZCI6ImN1cnJlbnRfa2V5IiwidHlwIjoiSldUIn0.eyJleHAiOjE1OTU1NjYzNjksImdyb3VwcyI6WyJwYy5hbm9ueW1
vdXMiXSwiaWF0IjoxNTk1NTU1NTY5LCJpc3MiOiJQQyIsImp0aSI6InJCMEVDYVdoOVh1Y2U5M3cyYkFETnVXOUszdkZoUGxuS0FpbVR3NVdFNWNueW
9VM0FBQUFCQS4uIiwicGNfYWNjb3VudE51bWJlcnMiOlsiMjU1ODM2MzEzOCJdLCJzdWIiOiJhdXRoIiwidGVuYW50X2lkIjoiTm9UZW5hbnQiLCJ0e
XBlIjoiYWNjb3VudEhvbGRlciJ9.Ix4GCz4nJg_QM3AsC-jVyZU_V8ysGBgWfvIxAIS59t7EN2C6Pi2QgJRs09y0ThqFX-_1-ucD58Vunqs5dMivJg

Die decodierte Nutzdaten für dieses JWT ist:

{
  "exp": 1595566369,
  "groups": [
    "pc.anonymous"
  ],
  "iat": 1595555569,
  "iss": "PC",
  "jti": "rB0ECaWh9Xuce93w2bADNuW9K3vFhPlnKAimTw5WE5cnyoU3AAAABA..",
  "pc_accountNumbers": [
    "2558363138"
  ],
  "sub": "auth",
  "tenant_id": "NoTenant",
  "type": "accountHolder"
}

Beachten Sie die folgenden Punkte: