API Documentation


/api/public/job/list-options


Delivers list of options found in the data returned by the Job API. The list contains all options and their translations. The options and translations can be managed by an admin in the 'Customizations' tab of Tamago-DB's Administration page.


Included : 

  • types : job type and candidate's employment type
  • categories : job category and candidate's desired job category
  • industries : job industry and candidate's desired industry
  • locations : job location and candidate's desired location
  • education_levels :  candidate's education level
  • source_types : candidate's source type
  • visa_types : candidate's visa type
  • language_abilities : job's required language ability, candidate's language ability


https://demo.tamago-db.com/api/doc#get--api-public-job-list-options


Request


curl -X GET "https://demo.tamago-db.com/api/public/job/list-options" -H 'x-auth-token: <api-key>'


Response


{
   "status":200,
   "data":{
      "types":{
         "full time":{
            "weight":0,
            "translations":{
               "en":"Full time",
               "ja":"\u6b63\u793e\u54e1",
               "es":"Tiempo completo",
               "zh":"\u5168\u804c"
            }
         },
         "contract":{
            "weight":2,
            "translations":{
               "en":"Contract",
               "ja":"\u5951\u7d04\u793e\u54e1",
               "es":"Contrato",
               "zh":"\u5408\u540c\u5236\u5458\u5de5"
            }
         },
         "contract to hire":{
            "weight":3,
            "translations":{
               "en":"Contract to hire",
               "ja":"\u5951\u7d04\u793e\u54e1\u304b\u3089\u6b63\u793e\u54e1",
               "es":"De honorarios a permanente",
               "zh":"\u5408\u540c\u8058\u7528"
            }
         },
         "internship":{
            "weight":4,
            "translations":{
               "en":"Internship",
               "ja":"\u30a4\u30f3\u30bf\u30fc\u30f3\u30b7\u30c3\u30d7",
               "es":"Internado"
            }
         },
         "part time":{
            "weight":5,
            "translations":{
               "en":"Part time",
               "ja":"\u30d1\u30fc\u30c8\u30bf\u30a4\u30e0",
               "es":"Medio tiempo",
               "zh":"\u517c\u804c"
            }
         },
         "temporary":{
            "weight":6,
            "translations":{
               "en":"Temporary",
               "ja":"\u6d3e\u9063",
               "es":"Temporalmente",
               "zh":"\u4e34\u65f6\u7684"
            }
         },
         "temp to perm":{
            "weight":7,
            "translations":{
               "en":"Temp to perm",
               "ja":"\u7d39\u4ecb\u4e88\u5b9a\u6d3e\u9063",
               "es":"Temporal a permanente",
               "zh":"\u4e34\u65f6\u8c03\u5ea6"
            }
         },
         "other":{
            "weight":8,
            "translations":{
               "en":"Other",
               "ja":"\u305d\u306e\u4ed6",
               "es":"Otro",
               "zh":"\u5176\u4ed6"
            }
         }
      },
      "categories":{
         "plan \/ sub cat 1":{
            "weight":0,
            "translations":{
               "ja":"\u4f01\u753b",
               "en":"Planning"
            }
         },
         "plan \/ sub cat 2":{
            "weight":1,
            "translations":{
               "ja":"\u30d7\u30ed\u30b0\u30e9\u30de\u30fc",
               "en":"Programmer"
            }
         },
         "planning \/ sub cat 3":{
            "weight":2,
            "translations":{
               "ja":"\u30c7\u30b6\u30a4\u30ca\u30fc",
               "en":"Designer"
            }
         },
         "conposer":{
            "weight":3,
            "translations":{
               "ja":"\u30b3\u30f3\u30dd\u30fc\u30b6\u30fc",
               "en":"Composer"
            }
         },
         "sales":{
            "weight":4,
            "translations":{
               "en":"Sales",
               "ja":"\u55b6\u696d"
            }
         },
         "marketing and pr":{
            "weight":5,
            "translations":{
               "en":"Marketing and PR",
               "ja":"\u30de\u30fc\u30b1\u30c6\u30a3\u30f3\u30b0\uff06PR"
            }
         },
         "doctor":{
            "weight":6,
            "translations":{
               "en":"Doctor",
               "ja":"\u533b\u5e2b"
            }
         },
         "quality assurance":{
            "weight":7,
            "translations":{
               "en":"Quality Assurance",
               "ja":"\u54c1\u8cea\u7ba1\u7406"
            }
         },
         "finance":{
            "weight":8,
            "translations":{
               "en":"Finance",
               "ja":"\u91d1\u878d"
            }
         },
         "salessupport":{
            "weight":9,
            "translations":{
               "ja":"\u30bb\u30fc\u30eb\u30b9\u30b5\u30dd\u30fc\u30c8",
               "es":"Sales Support",
               "en":"Sales Support"
            }
         }
      },
      "industries":{
         "it":{
            "weight":0,
            "translations":{
               "ja":"IT",
               "en":"IT"
            }
         },
         "maunfacture":{
            "weight":1,
            "translations":{
               "ja":"\u88fd\u9020\u696d",
               "en":"Manufacturing"
            }
         },
         "finance":{
            "weight":2,
            "translations":{
               "ja":"\u91d1\u878d",
               "en":"Finance"
            }
         },
         "healthcare":{
            "weight":3,
            "translations":{
               "en":"Healthcare",
               "ja":"\u30d8\u30eb\u30b9\u30b1\u30a2"
            }
         },
         "retail":{
            "weight":4,
            "translations":{
               "en":"Retail",
               "ja":"\u5c0f\u58f2"
            }
         },
         "automotive":{
            "weight":5,
            "translations":{
               "ja":"\u81ea\u52d5\u8eca",
               "es":"Automotive"
            }
         }
      },
      "locations":{
         "tokyo":{
            "weight":0,
            "translations":{
               "ja":"\u6771\u4eac",
               "en":"Tokyo"
            }
         },
         "kyushu":{
            "weight":2,
            "translations":{
               "ja":"\u4e5d\u5dde",
               "en":"Kyushu"
            }
         },
         "osaka":{
            "weight":1,
            "translations":{
               "ja":"\u5927\u962a",
               "en":"Osaka"
            }
         },
         "kobe":{
            "weight":3,
            "translations":{
               "en":"Kobe"
            }
         },
         "singapore":{
            "weight":5,
            "translations":{
               "en":"Singapore"
            }
         },
         "hong kong":{
            "weight":7,
            "translations":{
               "en":"Hong Kong"
            }
         },
         "saitama":{
            "weight":6,
            "translations":{
               "ja":"\u57fc\u7389",
               "es":"Saitama"
            }
         }
      },
      "education_levels":{
         "bachelors":{
            "weight":1,
            "translations":{
               "en":"Bachelors",
               "ja":"\u5927\u5352"
            }
         },
         "mba":{
            "weight":1,
            "translations":{
               "en":"MBA",
               "ja":"MBA"
            }
         }
      },
      "source_types":{
         "import":{
            "weight":1,
            "translations":{
               "en":"Import",
               "es":"import",
               "ja":"\u30a4\u30f3\u30dd\u30fc\u30c8"
            }
         },
         "self registered":{
            "weight":2,
            "translations":{
               "en":"Self registered",
               "ja":"\u5fdc\u52df"
            }
         },
         "linkedin":{
            "weight":3,
            "translations":{
               "en":"LinkedIn",
               "es":"LinkedIn",
               "ja":"LinkedIn"
            }
         }
      },
      "visa_types":{
         "engineer":{
            "weight":0,
            "translations":{
               "en":"Eng. \/ Spec. in Humanities \/ Int. Services",
               "ja":"\u6280\u8853\u30fb\u4eba\u6587\u77e5\u8b58\u30fb\u56fd\u969b\u696d\u52d9"
            }
         },
         "student":{
            "weight":1,
            "translations":{
               "ja":"\u7559\u5b66"
            }
         },
         "permanent":{
            "weight":2,
            "translations":{
               "ja":"\u6c38\u4f4f\u8005"
            }
         },
         "spouse":{
            "weight":3,
            "translations":{
               "ja":"\u65e5\u672c\u4eba\u306e\u914d\u5076\u8005"
            }
         },
         "techinterntrainee":{
            "weight":4,
            "translations":{
               "ja":"\u6280\u80fd\u5b9f\u7fd2"
            }
         },
         "needvisa":{
            "weight":5,
            "translations":{
               "ja":"\u65e5\u672c\u3067\u306e\u5c31\u52b4\u8a31\u53ef\u304c\u5fc5\u8981\u3067\u3059",
               "en":"Need working visa in Japan"
            }
         }
      },
      "language_abilities":{
         "none":{
            "numerical_value":0,
            "translations":{
               "en":"None",
               "es":"Ninguno",
               "ja":"\u306a\u3057",
               "zh":"\u65e0"
            }
         },
         "basic":{
            "numerical_value":1,
            "translations":{
               "en":"Basic",
               "es":"B\u00e1sico",
               "ja":"\u57fa\u790e\u4f1a\u8a71",
               "zh":"\u57fa\u672c\u4f1a\u8bdd"
            }
         },
         "conversation":{
            "numerical_value":2,
            "translations":{
               "en":"Conversation",
               "es":"Conversaci\u00f3n",
               "ja":"\u65e5\u5e38\u4f1a\u8a71",
               "zh":"\u65e5\u5e38\u4f1a\u8bdd"
            }
         },
         "business":{
            "numerical_value":3,
            "translations":{
               "en":"Business",
               "es":"Negocio\/Empresa",
               "ja":"\u30d3\u30b8\u30cd\u30b9\u4f1a\u8a71",
               "zh":"\u5546\u52a1\u4f1a\u8bdd"
            }
         },
         "business advanced":{
            "numerical_value":4,
            "translations":{
               "en":"Business advanced",
               "es":"business advanced",
               "ja":"\u4e0a\u7d1a\u30d3\u30b8\u30cd\u30b9\u30ec\u30d9\u30eb",
               "zh":"business advanced"
            }
         },
         "fluent":{
            "numerical_value":5,
            "translations":{
               "en":"Fluent",
               "es":"Fluido",
               "ja":"\u6d41\u66a2",
               "zh":"\u6d41\u5229\u7684"
            }
         },
         "native":{
            "numerical_value":6,
            "translations":{
               "en":"Native",
               "es":"Nativo",
               "ja":"\u30cd\u30a4\u30c6\u30a3\u30d6",
               "zh":"\u672c\u571f\u7684"
            }
         }
      }
   }
}


/api/public/job/search-options


Identical as the 'list-options' API, except the response will only contains values currently used in public jobs. This list can be used to create a search form to only contain selectable options of currently public jobs.


https://demo.tamago-db.com/api/doc#get--api-public-job-search-options

Request


curl -X GET "https://demo.tamago-db.com/api/public/job/list-options" -H 'x-auth-token: <api-key>'


Response


See /api/public/job/list-options