公開しているAPIについて

1. API 定義

Hire の API は GraphQL となります。

• スキーマ定義ファイル: public-schema.graphql 
• エンドポイント: https://ats-graphql-gateway.wantedly.com/public/graphql

2. API キーの発行

https://hire.wantedly.com/app/settings/organization/api_keys から API キーを発行することができます。
API キーの発行には組織管理者の権限が必要です。必要なアクセス許可（スコープ）は、スキーマ定義ファイルをご参照ください。

3. 認証

リクエスト時に次のような Authorization リクエストヘッダーを含めてください:

Authorization: Bearer <APIキー>

リクエスト例

curl --request POST \
   --header 'content-type: application/json' \
   --header 'Authorization: Bearer <APIキー>' \
   --url 'https://ats-graphql-gateway.wantedly.com/public/graphql' \
   --data '{"query":"query {\n  viewerCompanyAccessTokenMetadata {\n    scopes {\n      name\n    }\n  }\n}"}'

4. 主なAPI

各 API の詳細についてはスキーマ定義ファイルをご参照ください。

• Query.jobPositionsUsingOffset
  求人の一覧を取得します。
• Query.selectionsUsingOffset
  選考や選考に紐づく候補者の一覧を取得します。
• Query.viewerCompanyAccessTokenMetadata
  リクエストに使っている API キーの有効性を確認するためのクエリです。
  CompanyAccessTokenScope#name を見ることで API キーに設定されているスコープを確認することができます

定義ファイルのダウンロードは以下より可能です。