Superjob API FAQ (Stellenausschreibung)

Ich habe kürzlich über die Headhunter-API zum Veröffentlichen von Jobs gesprochen und Superjob erwähnt. Nachdem Sie nun dieselbe Funktionalität in der Superjob-API implementiert haben, können Sie Ihre Erfahrungen mit Ihnen teilen.


Bild


Arbeiten mit der Superjob API


Es gibt also die Aufgabe, offene Stellen bei Superjob zu veröffentlichen. Sie benötigen:


Aktuelle API-Version


Hier wird alles erwartet - die Versionierung ist vorhanden und wird in der URL übergeben:


https://api.superjob.ru/:version/method_name/:params 

Antragsregistrierung


Das einfachste Verfahren besteht auch darin, ein Konto zu erstellen, eine Anwendung zu erstellen und Token abzurufen. Ohne Erwartungen Registrierung und SMS .


redirect_uri , das in den Parametern übergeben wurde, ist anscheinend überhaupt nicht mit der in den Anwendungseinstellungen angegebenen Rückruf-URL verknüpft. Es (Rückruf-URL) kann nicht einmal angegeben werden, alles wird funktionieren.


Und auch


Geben Sie die erforderlichen Parameter an


Verantwortlichkeiten, Anforderungen und Bedingungen sind optionale Parameter der Vakanz, aber der Name des Unternehmens und eine Beschreibung seiner Aktivitäten müssen auf jede Vakanz übertragen werden.


Beim letzten Mal (auf HeadHunter) wurde versucht, den Link innerhalb der Stelle zu veröffentlichen. Hier wurde der url Parameter gefunden. Es war jedoch nicht möglich zu verstehen, wo er in der Stelle angezeigt wird.


Fordern Sie einen Link zu einer erstellten Stelle an


Anstelle des erwarteten Superjobs / Stellenangebots / ID wird der Link in Form von Stellenangebots-ID.html gebildet, aber nur die Stellenangebots-ID wird in die Antwort aufgenommen. Der russische Text wird durch einen unbekannten Algorithmus (oder gemäß einem von N GOSTs) transliteriert, was es unmöglich macht, einen Link auf seiner Seite zu bilden. Sie müssen eine separate Anfrage für die API-Route stellen, von der aus der vollständige Link bereits zurückgegeben wurde.


Wählen Sie zwischen Arbeitszeitplan und Art der Beschäftigung


Superjob kombiniert diese beiden Felder und bietet aus der Liste beispielsweise Teilzeit oder Teilzeit an. Dies ist unpraktisch, wenn es Party-Timer, befristete Verträge und andere Szenarien gibt.




Zusammenfassung


Über Formatierungen und Aufgaben ohne Analyse


Letztes Mal habe ich erwähnt, dass offene Stellen bei HeadHunter HTML unterstützen und ein WYSIWYG-Editor dafür auf der Website geschraubt ist. Neben der Aufgabe, Links in offenen Stellen zu veröffentlichen (was leicht fehlgeschlagen ist), ist auch die Aufgabe angekommen, WYSIWYG für sie in unserer Bewerbung zu befestigen. Der freie Text wird zusammen mit der Formatierung in der Datenbank gespeichert, sodass er auf die gleiche Weise zu Superjob geflogen ist, den HTML nicht unterstützt. Im Prinzip wird dies erwartet, aber das Hauptproblem ist, dass sich nach dem Betrachten der gleichen Stelle bei HeadHunter herausstellte, dass es auch keine gesendete Formatierung unterstützt! Tags werden einfach gelöscht und der bloße Text bleibt in der Ausgabe. Infolgedessen wird WYSIWYG herausgeschnitten, und alle mit HTML aufgezeichneten offenen Stellen müssen auf irgendeine Weise in drei Datenbanken analysiert und bereinigt werden.


Ich würde gerne viele schlechte Worte über Outsourcing schreiben, aber ein anderes Mal.


Über Bequemlichkeit


Wenn wir HeadHunter und Superjob vergleichen, ist es offensichtlich, dass mit letzterem alles viel einfacher ist. Die Integration wurde sehr schnell erstellt - die Fehlertexte waren nicht verwirrend, aufgrund der optionalen Rückruf-URL wurde alles in mehreren Umgebungen getestet.


Was mich verärgerte, war das Fehlen einer Superjob-API auf Github, aber dort hatte ich Spaß mit einem "einfachen Client" in PHP für fünfzehnhundert Zeilen. Es gibt ein Feedback für die Kommunikation mit dem technischen Support. In Form eines Aufrufs gibt es jedoch keine Kategorie von Fragen nach API. Nun, das.


Fazit


Im Allgemeinen kann man kaum eindeutig sagen, dass jemand besser ist, jemand schlechter. Superjob hat etwas zu beanstanden, aber am Ende bietet der Service eine normale API, die unsere Probleme vollständig löst.

Source: https://habr.com/ru/post/de465663/


All Articles