{
„openapi“: „3.1.0“,
„info“: {
„version“: „1.0“,
„title“: „AJO Job Finder Feed API“,
„description“: „Provides feeds of the AJO jobs in different flavours“
},
„servers“: [
{
„url“: „https://www.auslandsjob.de/ajo-job-finder-feed/“
}
],
„paths“: {
„/im-ausland-arbeiten“: {
„get“: {
„summary“: „Get the jobs as JSON“,
„responses“: {
„200“: {
„description“: „Successfully retrieved the jobs“,
„content“: {
„application/json“: {
„schema“: {
„type“: „object“,
„required“: [
„jobs“
],
„properties“: {
„jobs“: {
„type“: „array“,
„items“: {
„type“: „object“,
„properties“: {
„id“: {
„type“: „integer“,
„description“: „Unique ID of the job“,
„example“: 12345
},
„title“: {
„type“: „string“,
„description“: „The title of the job“,
„example“: „A beautiful job“
},
„url“: {
„type“: „string“,
„format“: „uri“,
„description“: „The URL to the job description page at auslandsjob.de“,
„example“: „auslandsjob.de/beautiful-job-1“
},
„thumbnail_urls“: {
„description“: „Different sizes of the job image or empty, if none set“,
„oneOf“: [
{
„type“: „object“,
„properties“: {
„thumbnail“: {
„description“: „The image cropped to 150×150 pixel“,
„$ref“: „#/components/schemas/Image_Array“
},
„medium“: {
„description“: „The image cropped to 300px width“,
„$ref“: „#/components/schemas/Image_Array“
},
„medium_large“: {
„description“: „The image cropped to 768px width“,
„$ref“: „#/components/schemas/Image_Array“
},
„large“: {
„description“: „The image cropped to 1140px width“,
„$ref“: „#/components/schemas/Image_Array“
},
„full“: {
„description“: „The full size image“,
„$ref“: „#/components/schemas/Image_Array“
}
},
„required“: [
„thumbnail“,
„medium“,
„medium_large“,
„large“,
„full“
]
},
{
„type“: „null“
}
],
„example“: {
„thumbnail“: [
„https://www.auslandsjob.de/wp-content/uploads/bar-steward-sea-chefs-titel-150×150.jpg“,
150,
150,
true
],
„medium“: [
„https://www.auslandsjob.de/wp-content/uploads/bar-steward-sea-chefs-titel-300×197.jpg“,
300,
197,
true
],
„medium_large“: [
„https://www.auslandsjob.de/wp-content/uploads/bar-steward-sea-chefs-titel-768×505.jpg“,
768,
505,
true
],
„large“: [
„https://www.auslandsjob.de/wp-content/uploads/bar-steward-sea-chefs-titel-1140×750.jpg“,
1140,
750,
true
],
„full“: [
„https://www.auslandsjob.de/wp-content/uploads/bar-steward-sea-chefs-titel.jpg“,
1490,
980,
false
]
}
},
„date_time_published“: {
„type“: „string“,
„format“: „date-time“,
„description“: „The date when the post was published“,
„example“: „2023-05-22 07:07:55“
},
„date_time_modified“: {
„type“: „string“,
„format“: „date-time“,
„description“: „The date when the post was last modified“,
„example“: „2023-05-22 07:07:55“
},
„category“: {
„type“: „string“,
„description“: „The category of the job“,
„enum“: [
„“,
„Automobilindustrie“,
„Bau & Handwerk“,
„Beauty & Wellness“,
„Beratung & Consulting“,
„Bildung & Unterricht“,
„Büro & Sachbearbeitung“,
„Computer & Technik“,
„Digitale Jobs“,
„Energie & Umwelt“,
„Entwicklungshilfe & Soziales“,
„Events & Promotion“,
„Farmarbeit“,
„Finanzen & Wirtschaft“,
„Forschung & Wissenschaften“,
„Gastronomie“,
„Gesellschaft & Politik“,
„Handwerk“,
„Hotel & Hostel“,
„Immobilien“,
„Industrie“,
„Jura & Recht“,
„Kundenservice & Beratung“,
„Kunst & Kultur“,
„Land- und Forstwirtschaft“,
„Lifestyle & Mode“,
„Management“,
„Marketing“,
„Medien & Kommunikation“,
„Medizin & Pflege“,
„Naturwissenschaften“,
„Öffentlicher Sektor“,
„Personalwesen & HR“,
„Sport & Fitness“,
„Tourismus“,
„Transport & Logistik“,
„Vertrieb & Verkauf“,
„Verwaltung“,
„Sonstiges“
]
},
„type“: {
„type“: „string“,
„description“: „The type of the job“,
„enum“: [
„“,
„Vollzeit“,
„Teilzeit“,
„Minijob“,
„Praktikum“,
„Sonstiges“
]
},
„start_date“: {
„type“: „string“,
„description“: „The start date. Can be text as well“,
„example“: „ab sfort“
},
„duration“: {
„type“: „string“,
„description“: „The duration of the job as text“,
„example“: „4 – 6 Monate“
},
„vacancies“: {
„type“: „string“,
„description“: „The vacancies for the job, can be text as well“,
„example“: „6“
},
„vacancies_note“: {
„type“: „string“,
„description“: „A note about the vacancies“
},
„external_url“: {
„type“: „string“,
„format“: „uri“,
„description“: „The URL to the direct job offer of the company providing it“,
„example“: „https://externer-anbieter.de/beautiful-job-1“
},
„description“: {
„type“: „string“,
„description“: „The (short) description of the job“
},
„country_string“: {
„type“: „string“,
„description“: „The country (location) of the job, can be descriptive text and/ or include multiple“,
„example“: „Vereinigte Arabische Emirate“
},
„address_string“: {
„type“: „string“,
„description“: „The address (location) of the job“,
„example“: „Dubai in den Vereinigten Arabischen Emiraten“
},
„flag_code“: {
„type“: „string“,
„description“: „The flag-code displayed with the job on auslandsjob.de. Always starts with \“flag-\“, followed by the country name. Might also contain europe or united-nations as country name“,
„example“: „flag-united-arab-emirates“
},
„company_name“: {
„type“: „string“,
„description“: „The name of the country“,
„example“: „Very nice Company“
},
„company_logo_urls“: {
„description“: „Different sizes of the company logo image or empty, if none set“,
„oneOf“: [
{
„type“: „object“,
„properties“: {
„thumbnail“: {
„description“: „The image cropped to 150×150 pixel“,
„$ref“: „#/components/schemas/Image_Array“
},
„medium“: {
„description“: „The image cropped to 300px width“,
„$ref“: „#/components/schemas/Image_Array“
},
„full“: {
„description“: „The full size image“,
„$ref“: „#/components/schemas/Image_Array“
}
},
„required“: [
„thumbnail“,
„medium“,
„full“
]
},
{
„type“: „null“
}
],
„example“: {
„thumbnail“: [
„https://www.auslandsjob.de/wp-content/uploads/SeaChefs_Button_Outline_BesteJobs_4c-150×150.jpg“,
150,
150,
true
],
„medium“: [
„https://www.auslandsjob.de/wp-content/uploads/SeaChefs_Button_Outline_BesteJobs_4c-300×300.jpg“,
300,
300,
true
],
„full“: [
„https://www.auslandsjob.de/wp-content/uploads/SeaChefs_Button_Outline_BesteJobs_4c.jpg“,
1890,
1890,
false
]
}
},
„company_urls“: {
„description“: „URLs to different platforms where the company is represented“,
„type“: „object“,
„properties“: {
„website“: {
„type“: „string“,
„format“: „uri“,
„example“: „https://externer-anbieter.de“
},
„facebook“: {
„type“: „string“,
„format“: „uri“
},
„linkedin“: {
„type“: „string“,
„format“: „uri“
},
„instagram“: {
„type“: „string“,
„format“: „uri“
},
„snapchat“: {
„type“: „string“,
„format“: „uri“
},
„tiktok“: {
„type“: „string“,
„format“: „uri“
},
„youtube“: {
„type“: „string“,
„format“: „uri“
},
„xing“: {
„type“: „string“,
„format“: „uri“
},
„twitter“: {
„type“: „string“,
„format“: „uri“
}
}
},
„highlight“: {
„description“: „If to highlight the job in the results“,
„type“: „boolean“
}
},
„required“: [
„id“,
„title“,
„url“,
„thumbnail_urls“,
„date_time_published“,
„date_time_modified“,
„category“,
„type“,
„start_date“,
„duration“,
„vacancies“,
„vacancies_note“,
„external_url“,
„description“,
„country_string“,
„address_string“,
„flag_code“,
„company_name“,
„company_logo_urls“,
„company_urls“,
„highlight“
]
}
}
}
}
}
}
},
„404“: {
„description“: „No feed for given slug“
}
}
}
}
},
„components“: {
„schemas“: {
„Image_Array“: {
„description“: „The first value holds the image URL (string), the second and third the width and height (integer), the last states if the image was cropped (boolean)“,
„type“: „array“,
„items“: [
{
„type“: „string“,
„format“: „uri“,
„description“: „Image URL“
},
{
„type“: „integer“,
„description“: „Width of the image“
},
{
„type“: „integer“,
„description“: „Height of the image“
},
{
„type“: „boolean“,
„description“: „Indicates if the image was cropped“
}
],
„minItems“: 4,
„maxItems“: 4,
„example“: [
„https://www.auslandsjob.de/wp-content/uploads/SeaChefs_Button_Outline_BesteJobs_4c-150×150.jpg“,
150,
150,
true
]
}
}
}
}