Zum Inhalt springen

Endpunkt für Bereitstellungen im Jitterbit App Builder

Einführung

Mit App Builder 4.52 und später können Sie REST-Endpunkte verwenden, um die Details von Releases abzurufen oder um mit deren Erstellung zu beginnen:

Voraussetzungen

  • Sie müssen einen API-Schlüssel auf dem Server generieren und Mitglied der Rolle Deployment sein.

release-Endpunkt

Mit diesem Endpunkt können Sie Folgendes tun:

  • GET: Informationen zu einem bestimmten Release oder einer bestimmten Lösung abrufen.

  • POST: Ein Release erstellen.

Antworten können die folgenden Felder enthalten:

  • releaseId: Release-Identifikator.

  • solutionId: Lösungs-Identifikator.

  • name: Release-Name (entspricht dem Lösungsnamen).

  • version: Vom Entwickler bereitgestellte Versionsnummer.

  • releaseNotes: Vom Entwickler bereitgestellte Release-Notizen.

  • releaseDate: Vom Entwickler bereitgestelltes Veröffentlichungsdatum.

  • status: Nur-lesbarer Build-Status. Mögliche Werte sind:

    • Warteschlange
    • Wird gebaut
    • Gebaut
    • Fehlgeschlagen

  • fileName: Paket (LP) Dateiname.

  • file: Base64-kodierte Paketdatei.

  • snapshot: Flag, um anzuzeigen, ob vor dem Erstellen des Releases ein Snapshot erstellt werden soll.

GET /rest/v1/vinyl-deploy/release?solutionId={{ solutionId }}

Die angegebenen Lösungs-Releases abrufen.

  • solutionId: Lösungs-Identifikator.
Beispiel 
GET https://example.com/rest/v1/vinyl-deploy/release?solutionId=4df8b502-56d0-498a-98de-511b4134ee3c
Accept: application/json
X-Api-Key: abcdef.1234567890


HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "count": null,
  "items": [
    {
      "releaseId": "1e3690ef-afff-4a4a-919e-01e100b259d7",
      "solutionId": "4df8b502-56d0-498a-98de-511b4134ee3c",
      "name": "Customers",
      "version": "1.0",
      "releaseNotes": "Added company name.",
      "releaseDate": "2025-11-06T00:00:00"
    },
    {
      "releaseId": "ad16337f-d677-4527-84f1-651bd928238a",
      "solutionId": "4df8b502-56d0-498a-98de-511b4134ee3c",
      "name": "Customers",
      "version": "1.0",
      "releaseNotes": null,
      "releaseDate": "2025-10-27T00:00:00"
    }
  ],
  "message": null,
  "validations": [],
  "status": 200
}

GET /rest/v1/vinyl-deploy/release/{{ releaseId }}

Die Informationen für ein bestimmtes Release abrufen, einschließlich der base64-kodierten Paketdatei.

  • releaseId: Release-Identifikator.
Beispiel 
GET https://example.com/rest/v1/vinyl-deploy/release/1e3690ef-afff-4a4a-919e-01e100b259d7?solutionId=4df8b502-56d0-498a-98de-511b4134ee3c
Accept: application/json
X-Api-Key:  abcdef.1234567890


HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "item": {
    "releaseId": "9b5211e1-402a-4f04-b87d-33f28a55987a",
    "solutionId": "4df8b502-56d0-498a-98de-511b4134ee3c",
    "name": "Customers",
    "version": "1.0",
    "releaseNotes": "These are my release notes.",
    "releaseDate": "2025-11-06T00:00:00",
    "status": "built",
    "fileName": "Customers-1.0.LP",
    "file": "...Base64-encoded file...",
    "snapshot": false
  },
  "message": null,
  "validations": [],
  "status": 200
}

POST /rest/v1/vinyl-deploy/release

Ein Release erstellen.

Wichtig

Dies ist eine synchrone (blockierende) Operation: Der Server antwortet nicht, bis der Build abgeschlossen ist, unabhängig davon, ob er erfolgreich war oder nicht.

Beispiel 
POST https://example.com/rest/v1/vinyl-deploy/release
Content-Type: application/json
X-Api-Key:  abcdef.1234567890

{
    "solutionId": "4df8b502-56d0-498a-98de-511b4134ee3c",
    "releaseNotes": "Added company name.",
    "snapshot": false
}


HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "item": {
    "releaseId": "9b5211e1-402a-4f04-b87d-33f28a55987a",
    "solutionId": "4df8b502-56d0-498a-98de-511b4134ee3c",
    "name": "Customers",
    "version": "1.0",
    "releaseNotes": "These are my release notes.",
    "releaseDate": "2025-11-06T00:00:00",
    "status": "built",
    "fileName": "Customers-1.0.LP",
    "file": "...Base64-encoded file...",
    "snapshot": false
  },
  "message": null,
  "validations": [],
  "status": 200
}

release-queue Endpunkt

Reichen Sie eine Build-Anfrage in die Warteschlange ein.

Antworten können die folgenden Felder enthalten:

  • releaseId: Release-Identifikator.

  • solutionId: Lösungs-Identifikator.

  • name: Release-Name (entspricht dem Lösungsnamen).

  • version: Vom Entwickler bereitgestellte Version.

  • releaseNotes: Vom Entwickler bereitgestellte Release-Notizen.

  • releaseDate: Vom Entwickler bereitgestelltes Release-Datum.

  • status: Build-Status. Nur lesbar. Werte sind: queued, building, built und failed.

  • snapshot: Flag, um anzuzeigen, ob ein Snapshot vor dem Build des Releases erstellt werden soll.

POST /rest/v1/vinyl-deploy/release-queue

Stellen Sie einen Release-Build in die Warteschlange.

Wichtig

Dies ist eine asynchrone, nicht blockierende Operation. Der Server gibt sofort zurück; der Build findet im Hintergrund statt. Entwickler müssen den aktuellen Status abfragen, um zu bestimmen, wann der Build abgeschlossen ist.

Beispiel 
POST https://example.com/rest/v1/vinyl-deploy/release-queue
Content-Type: application/json
X-Api-Key:  abcdef.1234567890

{
    "solutionId": "4df8b502-56d0-498a-98de-511b4134ee3c",
    "releaseNotes": "Added company name.",
    "snapshot": false
}


HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "item": {
    "releaseId": "9b5211e1-402a-4f04-b87d-33f28a55987a",
    "solutionId": "4df8b502-56d0-498a-98de-511b4134ee3c",
    "name": "Customers",
    "version": "1.0",
    "releaseNotes": "Added company name.",
    "releaseDate": "2025-11-06T00:00:00",
    "status": "queued",
    "snapshot": false
  },
  "message": null,
  "validations": [],
  "status": 200
}

GET /rest/v1/vinyl-deploy/release-queue/{{ releaseId }}?solutionId={{ solutionId }}

Rufen Sie den aktuellen Status eines in der Warteschlange befindlichen Releases ab.

  • releaseId: Release-Identifikator.

  • solutionId: Lösungs-Identifikator.

Beispiel 
GET https://example.com/rest/v1/vinyl-deploy/release-queue/9b5211e1-402a-4f04-b87d-33f28a55987a
Content-Type: application/json
X-Api-Key:  abcdef.1234567890


HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "item": {
    "releaseId": "9b5211e1-402a-4f04-b87d-33f28a55987a",
    "solutionId": "4df8b502-56d0-498a-98de-511b4134ee3c",
    "name": "Customers",
    "version": "1.0",
    "releaseNotes": "Added company name.",
    "releaseDate": "2025-11-06T00:00:00",
    "status": "built",
    "snapshot": false
  },
  "message": null,
  "validations": [],
  "status": 200
}