Schnellstart: Zencoder

Das Herzstück von Zencoder ist der Codierungsdienst. Zencoder verwendet Ihre Video-on-Demand-Inhalte (VOD) als Eingabe, codiert sie, erzeugt Ausgaben mit dem von Ihnen angegebenen Format und anderen Einstellungen und liefert sie an die Ziele Ihrer Wahl. In dieser Einführung erfahren Sie, wie Sie einen Basisjob einreichen.

Zencoder-API

Alle Vorgänge werden mit der Zencoder-API ausgeführt. Obwohl es eine gibt Builder anfordern Damit Sie einige grundlegende API-Anforderungen ausprobieren können, werden Sie wahrscheinlich bald direkt auf die API zugreifen. In diesem Handbuch können Sie die unten gezeigten cURL-Befehle oder einen REST-API-Client wie z Postbote.

Wenn Sie mit cURL nicht vertraut sind, lesen Sie Richten Sie cURL ein.

Eine Anfrage stellen

Die Aufforderung zur Einreichung eines Auftrags lautet a POST Anfrage gesendet an:

https://app.zencoder.com/api/v2/jobs

Erforderliche Header

Es gibt zwei Header, die zusammen mit der Anfrage gesendet werden müssen:

  • Zencoder-Api-Key: YOUR_API_KEY
  • Content-Type: application/json

Sie können Ihren API-Schlüssel unter besuchen https://app.zencoder.com/api. Für diese Übung können Sie einen Vollzugriffs- oder Nur-Integrationsschlüssel verwenden.

Mehr Informationen

Die Anforderung kann (und würde normalerweise) Ausgabeeinstellungen für den Job enthalten, einschließlich eines Ausgabeziels, Benachrichtigungseinstellungen und Transcodierungseinstellungen. In dieser einfachen Übung überspringen wir dies, aber weitere Informationen finden Sie in der Codierungseinstellungen.

Wir unterstützen derzeit das Herunterladen von Dateien mit HTTP / HTTPS, S3, Cloud-Dateien, FTP / FTPS, SFTP und Aspera.

Eine einfache neue Stellenanfrage muss lediglich die URL der Eingabedatei im Hauptteil sowie den API-Schlüssel Ihres Kontos in einem Header namens angeben Zencoder-Api-Key.

  {
  "input": "s3://zencodertesting/test.mov"
  }

Sie können dies folgendermaßen testen cURL Befehl.

  curl --header "Zencoder-Api-Key: YOUR_API_KEY" \
       --header "Content-Type: application/json" \
       --data '{"input":"s3://zencodertesting/test.mov"}' \
       https://app.zencoder.com/api/v2/jobs

Kopieren Sie diesen Code in einen Texteditor und ersetzen Sie ihn YOUR_API_KEY mit Ihrem API-Schlüssel. Öffnen Sie dann eine Eingabeaufforderung, kopieren Sie den Befehl cURL, fügen Sie ihn an der Eingabeaufforderung ein und drücken Sie die Eingabetaste.

Hinweis für Windows-Benutzer: Aufgrund einer Einschränkung in cURL unter Windows müssen Sie doppelte Anführungszeichen wie vermeiden \" und wickeln Sie die --data Inhalt in doppelten Anführungszeichen anstelle von einfachen Anführungszeichen.

Diese Anforderung erstellt einen Codierungsjob für das Konto und versucht, die Datei unter s3: //zencodertesting/test.mov herunterzuladen und an das Standardausgabeziel zu transkodieren.

Antwort

Wenn Sie einen neuen Codierungsjob über die API erstellen, antwortet unser Server sofort mit Details zu dem Job und den Ausgabedateien, die erstellt werden. Sie sollten den Job speichern und IDs ausgeben, um sie während des Codierungsprozesses zu verfolgen. Notiere dass der id ist eine Ganzzahl im 64-Bit-Bereich.

Die Daten werden im JSON-Format zurückgegeben.

Das vorherige Beispiel für einen neuen Codierungsjob würde Folgendes mit a zurückgeben 201 Created Statuscode.

  {
    "id": 366118847,
    "outputs": [
      {
        "id": 1297606670,
        "label": null,
        "url": "https://zencoder-temp-storage-us-east-1.s3.amazonaws.com/o/20170422/69a1a537e5b40f91c172e6b033827159/9ea8d51bc1a71545eb9c700c0379e950.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAI456JQ76GBU7FECA%2F20170422%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20170422T214927Z&X-Amz-Expires=86399&X-Amz-SignedHeaders=host&X-Amz-Signature=9c0b05565dabcd5d7405a882956ef2babff6173c80cbafa36b2bd12df569e594"
      }
    ]
  }

Hinweis: Ein Auftrag kann dennoch fehlschlagen, weil die Eingabedatei nicht existiert, der Ausgabespeicherort ungültig ist, die Datei selbst ist oder andere Gründe vorliegen.