Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Web Development

Wie man die neuesten Updates für die Marketplace-API verwenden kann

by
Read Time:15 minsLanguages:

German (Deutsch) translation by Tatsiana Bochkareva (you can also view the original English article)

Die Envato-Marktplätze explodieren mit mehr als 600.000 Mitgliedern und über 65.000 Dateien!

Eine großartige Ergänzung zu den Marktplätzen ist die API, die dank der neuesten Updates jeden Tag beliebter wird! Unsere großartigen Marktentwickler hören ständig auf das Feedback der Community und haben der Edge-Veröffentlichung einige süße Funktionen hinzugefügt!

Schauen Sie sich unbedingt einige der im Internet verfügbaren Anwendungen an, die alle von der Envato-API unterstützt werden.

Heute schauen wie in den neuesten API-Funktionen nach! Begleiten Sie mich nach dem Sprung!


Was ist eine API?

Ein Application-Programming-Interface (Programmierschnittstelle-API) ist ein bestimmter Satz von Regeln und Spezifikationen, denen ein Softwareprogramm folgen kann, um auf die von einem anderen bestimmten Softwareprogramm bereitgestellten Dienste und Ressourcen zuzugreifen und diese zu nutzen. Es dient als Schnittstelle zwischen verschiedenen Programmen und erleichtert deren Interaktion, ebenso, wie eine Benutzeroberfläche die Interaktion zwischen Menschen und Computern erleichtert.

Web-API

Mit Web-APIs können Sie mehrere Dienste zu neuen Anwendungen kombinieren, die als Hybridanwendungen bezeichnet werden.

Bei Verwendung im Kontext der Webentwicklung besteht eine API in der Regel aus einem definierten Satz von HTTP-Hypertext-Übertragungsprotokoll (eng.Hypertext Transfer Protocol) sowie einer Definition der Struktur von Antwortnachrichten, die normalerweise in einer XML-Datei (Extensible Markup Language) oder JavaScript vorliegt JSON-Format (Object Notation).

Während "Web-API" praktisch ein Synonym für Webdienst ist, hat sich der jüngste Trend von SOAP-basierten Diensten (Simple Object Access Protocol) hin zu einer direkteren Kommunikation im REST-Stil (Representational State Transfer) verlagert. Web-APIs ermöglichen die Kombination mehrerer Dienste zu neuen Anwendungen, die als Mashups bezeichnet werden.


Werden APIs häufig verwendet?

Die meisten Entwickler kennen die Antwort auf diese Frage, aber für die anderen ist die Antwort ein klares JA.

APIs kann man überall finden; sie sind besonders beliebt im Bereich der sozialen Netzwerke! Die meisten großen Netzwerke, wie Twitter und Facebook, bieten APIs für die Interaktion mit ihrem Dienst.


Neue API-Funktionen

In diesem Tutorial werden wir uns nur mit den neuen API-Funktionen befassen. Wenn Sie mehr über die vorhandenen API-Funktionen erfahren möchten, lesen Sie unbedingt Drews Tutorial zu diesem Thema.

Publikum

  • item - Details für einen einzelnen Artikel, angegeben durch die angegebene ID.
  • item-prices - Geben Sie die verfügbaren Lizenzen und Preise für die angegebene Artikel-ID zurück.
  • user-items-by-site - Zeigt die Anzahl der Artikel, die ein Autor auf jeder Site zum Verkauf anbietet. Benötigt einen Benutzernamen, z.B. collis.

Privat

  • verify-purchase - Details eines Kaufs. Erfordert einen Kaufcode, z.B. Kauf bestätigen: 550e8400-e29b-41d4-a716-446655440000.
  • download-purchase - URL zum Herunterladen des Kaufs. Erfordert einen Kaufcode, z.B. Download-Kauf: 550e8400-e29b-41d4-a716-446655440000

Voraufsetzungen

Tutorial imageTutorial imageTutorial image

Sie  benötigen ein Envato Marketplace-Konto und einen API-Schlüssel, um mit der API beginnen zu können

Sie können Ihren API-Schlüssel abrufen, indem Sie die Seite mit den Kontoeinstellungen aufrufen.

Tutorial imageTutorial imageTutorial image

Wir werden eine PHP-Funktion namens json_decode verwenden. Auf diese Weise können wir die API-Daten abrufen und in ein Array konvertieren. Diese Funktion ist in PHP 5 >= 5.2.0 enthalten.

Haben Sie alles? Fangen wir an!


Schritt 1 - Aufbau unserer Klasse

Beginnen wir mit der Erstellung einer einfachen PHP-Klasse, mit der wir Daten von der API abrufen können.

Erstellen Sie einen neuen Projektordner und ein anderes Verzeichnis mit dem Namen classes, um alles zu organisieren. Fügen Sie in diesem Ordner eine neue PHP-Datei mit dem Namen envato.api.class.php hinzu

Zuerst konstruieren wir das Grundgerüst unserer Klasse:


Schritt 2 - Globale Variablen

Wir brauchen ein paar Variablen in unserer Klasse, um sie flexibel zu machen. Um herauszufinden, welche Variablen wir benötigen, müssen wir uns die Formatierung der API-URL ansehen.

  • Public - http://marketplace.envato.com/api/edge/set.json
  • Private - http://marketplace.envato.com/api/edge/username/api-key/set.json

Wie Sie sehen, benötigen wir insgesamt vier Variablen:

  • API Url
  • Set
  • Username
  • API Key

Erstellen wir diese privaten Variablen wie folgt:


Schritt 3 - Setter und Getter-Methoden

Ich verwende gerne Setter- und Getter-Methoden, wenn ich Klassen in PHP erstelle. Was genau sind diese Methoden? Ich habe unten ein kleines Beispiel gemacht:

Der obige Code funktioniert nicht und soll den folgenden Fehler zurückgeben:

Da die Variable auf privat gesetzt ist, können wir nicht darauf zugreifen oder sie ändern. Wenn wir die API-URL ändern müssen, ohne die Klassendatei zu bearbeiten, können wir Folgendes tun:

Wechseln Sie nun zurück zur PHP-Klasse und fügen Sie die Funktion set_api_url hinzu.

Da diese Funktion in unserer Klasse enthalten ist, können wir auf die private Variable api_url zugreifen und diese ändern. In diesem Tutorial brauchen wir keine Getter, aber lassen Sie uns trotzdem einen erstellen, um Ihnen ein besseres Verständnis des Konzepts zu vermitteln.

Wie Sie vielleicht an dieser Stelle gefolgert haben, benötigen wir beispielsweise keine get-Funktion für den API-Schlüssel. Das macht unsere Klasse sicherer.


Schritt 4 - Abschluss der restlichen Setter

Wir haben bereits einen Setter fertiggestellt, es sind also noch drei übrig, und alle haben die gleiche Struktur.

Set Username

Set API Key

Set API Set

Wir können jetzt alle Variablen wie folgt einstellen:


Schritt 4 - Daten anfordern

Erstellen wir eine Funktion, die die Daten von der Envato Marketplace-API anfordert. Wir beginnen mit der Erstellung einer neuen öffentlichen Funktion mit dem Namen request.

Wir können dieselbe Technik verwenden, die im vorherigen Tutorial verwendet wurde. Um die Daten von der API anzufordern, können wir cURL verwenden. Beginnen wir mit der Erstellung der API-URL. Wenn der Benutzername und der API-Schlüssel festgelegt sind, benötigen wir eine andere URL.

Wir senden eine Anfrage mit cURL wie folgt an die API:

Wir haben jetzt eine Variable namens $ch_data, die eine JSON-formatierte Zeichenfolge enthält. Bevor wir etwas damit anfangen können, müssen wir es in ein Array dekodieren.

Die Funktion in ihrer Gesamtheit sieht so aus:


Schritt 5 - Testen der Funktion

Probieren wir unsere Klasse aus und fordern einige Daten von der API an:

Tutorial imageTutorial imageTutorial image

Schritt 6 - Testen der neuen Funktionen der öffentlichen API

Jetzt, da unsere Klasse arbeitet, ist es Zeit, einige Beispiele mit den neuen API-Funktionen zu erstellen.

Item

Um Informationen zu einem Marktplatzartikel anzufordern, müssen wir der API eine item ID bereitstellen. Sie finden die item ID unter der URL des Marktplatzartikels.

Tutorial imageTutorial imageTutorial image

Nachdem wir unsere ID haben, fordern wir die Artikelinformationen an:

Die folgenden Daten sollten zurückgegeben werden:

Erstellen wir nun eine einfache Seite, auf der die oben genannten Informationen so angezeigt werden, dass andere Benutzer sie verstehen. Zuerst müssen wir die API-Daten einer Variablen zuweisen:

Wir können jetzt Daten von der API im folgenden Format anzeigen: $data['item']['key'].

Der HTML-Code nach dem PHP wird analysiert:

Tutorial imageTutorial imageTutorial image

item-prices

Anstatt eine neue API-Anfrage zu erstellen, um mehr über den Artikelpreis und die Lizenz zu erfahren, können wir sie einfach zum aktuellen API-Set hinzufügen.

Die Antwort der API ist unten:

Jetzt können wir diese zurückgegebenen Informationen auf unserer Artikelseite verwenden.

Tutorial imageTutorial imageTutorial image

user-items-by-site

Zum Abschluss fügen wir die Anzahl der Elemente hinzu, über die der Benutzer verfügt. Wir können es einfach zum API-Set hinzufügen.

Und die Antwort:

Fügen wir diese Informationen unserer Seite hinzu.

Tutorial imageTutorial imageTutorial image

Schritt 7 - Die Tests der neuen Funktionen der privaten API

Um die Funktionen der privaten API nutzen zu können, benötigen Sie ein Marktplatzkonto und einen Kaufcode von einem Ihrer Kunden. Wir müssen zuerst diese Informationen definieren.

verify-purchase

Dadurch wird die API-URL automatisch von öffentlich zu privat geändert. Um die Dinge etwas dynamischer zu gestalten, können wir ein kleines Formular erstellen, in das der Benutzer einige Informationen eingeben kann, um seinen Kauf zu überprüfen.

Hinweis: Verwenden Sie beim Erstellen Ihrer eigenen Website keine solchen Inline-Stile!

Das gibt uns eine Grundform:

Tutorial image

Kommen wir nun zum PHP-Teil.

Zunächst müssen wir prüfen, ob das Formular mit den erforderlichen Feldern gesendet wurde. Wenn Sie sie auf einer Live-Website verwenden, müssen Sie mehr Validierung hinzuzufügen, um die Sicherheit zu erhöhen.

Und jetzt die API-Anfrage.

Eine gültige API-Antwort sieht folgendermaßen aus:

Wenn die Anforderung ungültig ist, gibt die API ein leeres Array zurück. Wenn wir eine Antwort von der API erhalten, bedeutet dies, dass der Kaufcode korrekt ist. Um die Sicherheit zu erhöhen, werden wir es mit der eingegebenen item ID und dem username abgleichen.

Tutorial imageTutorial imageTutorial image

download-purchase

Mit dem Download-Kauf-Set können Sie Ihre eigenen Einkäufe herunterladen, ohne den Marktplatz zu besuchen.

Hinweis: Der Download-Kauf funktioniert nur, wenn Sie Ihren eigenen API-Schlüssel und einen Kaufcode eines von Ihnen gekauften Produkts verwenden.

Nachdem wir unser Kontrollkästchen aktiviert haben, nehmen wir einige Änderungen am Überprüfungsprozess vor.

Wir beginnen mit der Erstellung einer neuen Variablen.

Wir müssen auch einige Änderungen am verbleibenden Code vornehmen:

Mit diesen Änderungen sollte die Antwort folgendermaßen aussehen:


Abschluss

Ich hoffe, Sie haben etwas über die Marktplatz-API von Envato gelernt. Wenn ja, dann nutzen Sie dieses Wissen und erstellen Sie einige süße Anwendungen! Vielen Dank für das Lesen und lassen Sie uns wissen, wenn Sie Fragen oder Bedenken haben.

Advertisement
Did you find this post useful?
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.