連携ドキュメント

API Reference

メソッド 目的
GET oauth/authorize 許可コードのリクエストをおこないます。
POST oauth/token アクセストークンをリクエストをおこないます。
GET api/user ユーザー情報取得のリクエストをおこないます。

GET oauth/authorize

Resource URL

https://engilio-api.maitakajp.com/oauth/authorize

Headers

特別なヘッダーは必要ありません。

Input parameters

client_id 「Client ID」を設定してください。
redirect_uri 「コールバックURL」を設定してください。
response_type 'code' 固定
scope '*' 固定

Output parameters

クエリパラメータで返却されます。

code 許可コード

POST oauth/token

Resource URL

https://engilio-api.maitakajp.com/oauth/token

Headers

特別なヘッダーは必要ありません。

Input parameters

grant_type 'authorization_code' 固定
client_id 「Client ID」を設定してください。
client_secret 「Client Secret」を設定してください。
redirect_uri 「コールバックURL」を設定してください。
code 「GET oauth/authorize」で取得した「許可コード」を設定してください。

Output parameters

レスポンスボディにJSONで返却されます。

token_type トークンタイプ
expires_in 有効期限（秒）
access_token アクセストークン
refresh_token リフレッシュトークン

GET api/user

Resource URL

https://engilio-api.maitakajp.com/api/user

Headers

Content-Type 'application/json' 固定
Authorization 「GET oauth/token」で取得した「アクセストークン」を
設定してください。

Input parameters

必要ありません。

Output parameters

レスポンスボディにJSONで返却されます。下記サンプルコード中の「取得例」にてご確認ください。

status 処理結果
success: 成功
error: エラー
results ユーザー情報 ※下記の配列が含まれます
nickname ニックネーム
name_last 名前（姓）
name_first 名前（名）
name_kana_last 名前よみがな（姓）
name_kana_first 名前よみがな（名）
birth 生年月日
phone 電話番号
address_pref 住所（都道府県）
address_locality 住所（市区町村）
address_street 住所（以降）
postal_code 郵便番号
sex 性別
annual_income 年収
hitokoto 一言
pr PR
url URL
develops 開発経歴 (*1)
develop_name 案件名
develop_start_date_year 期間（開始年）
develop_start_date_month 期間（開始月）
develop_end_date_year 期間（終了年）
develop_end_date_month 期間（終了月）
develop_summary 開発内容
develop_env 開発環境
develop_role 役割
develop_scale 規模
develop_url 参考URL
companies 職歴 (*1)
company_name 会社名
company_start_date_year 期間（開始年）
company_start_date_month 期間（開始月）
company_end_date_year 期間（終了年）
company_end_date_month 期間（終了月）
company_contract_type 雇用形態
skills 保有スキル (*1)
skill_name スキル名
skill_experience 経験年数 ※0はプライベートのみまたは未経験
qualifications 保有資格 (*1)
qualification_name 資格名
qualification_at_year 取得年月（年）
qualification_at_month 取得年月（月）
（*1）含まれる情報のオブジェクトのキーにはユニークな文字列が入ります。

サンプルコード

redirect.php 
                                
<?php

    // クエリパラメータ
    $query = http_build_query([
        'client_id'     => '1',                                 // 払い出されたClient IDを設定してください
        'redirect_uri'  => 'https://example.com/callback.php',  // 設定したコールバックURLを設定してください
        'response_type' => 'code',
        'scope'         => '*',
    ]);
    header('Location: https://engilio-api.maitakajp.com/oauth/authorize?' . $query);
    exit;
callback.php 
                                
<?php

    // POST送信データ
    $data = array(
        'grant_type'    => 'authorization_code',
        'client_id'     => '1',                                 // 払い出されたClient IDを設定してください
        'client_secret' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxx',      // 払い出されたClient Secretを設定してください
        'redirect_uri'  => 'https://example.com/callback.php',  // 設定したコールバックURLを設定してください
        'code'          => $_GET['code'],
    );

    // ヘッダ設定
    $header = array(
        "Content-Type: application/x-www-form-urlencoded",
        "Content-Length: ".strlen(http_build_query($data, "", "&")),
    ); 
 
    // 送信オプション
    $options = array('http' => array(
        'method' => 'POST',
        'header' => implode("\r\n", $header),
        'content' => http_build_query($data, "", "&"),
    ));

    $response = json_decode(file_get_contents('https://engilio-api.maitakajp.com/oauth/token', 
                    false, stream_context_create($options)), TRUE);
get.php 
                                
<?php

    // ヘッダ設定
    $header = array(
        "Content-Type: application/json",
        "Authorization: Bearer " . $response['access_token'],
    );

    // 送信オプション
    $options = array('http' => array(
        'method' => 'GET',
        'header' => implode("\r\n", $header),
    ));

    // リクエスト
    $user = file_get_contents($url, false, stream_context_create($options));
    echo $contents;
GET api/user で取得したサンプルです 
                                
{
    "status":"success",
    "results":{
        "nickname":"不動のエースエンジニア",
        "name_last":"山田",
        "name_first":"太郎",
        "name_kana_last":"やまだ",
        "name_kana_first":"たろう",
        "birth":"1990-10-06",
        "phone":"09012345678",
        "address_pref":"東京都",
        "address_locality":"千代田区",
        "address_street":"丸の内１丁目",
        "postal_code":"1000005",
        "sex":"男性",
        "annual_income":"500",
        "hitokoto":"これからですよ！",
        "pr":"Webサイト・Webシステムの開発ならまかせてください！",
        "url":"https:\/\/engilio.maitakajp.com\/",
        "develops":{
            "00000001-IxBTIhU":{
                "develop_name":"求人サイト開発",
                "develop_start_date_year":"2019年",
                "develop_start_date_month":"1月",
                "develop_end_date_year":"2019年",
                "develop_end_date_month":"4月",
                "develop_summary":"求人一覧表示機能、求人詳細画面表示機能、求人応募機能、お気に入り登録・表示機能、および管理機能",
                "develop_env":"AWS, PHP, MySQL, Laravel, jQuery, HTML, CSS",
                "develop_role":"開発リーダー兼SE",
                "develop_scale":"プロジェクト人員：10名",
                "develop_url":null
            },
            "00000002-gnFzBHA":{
                "develop_name":"社内ポータルサイト開発",
                "develop_start_date_year":"2018年",
                "develop_start_date_month":"9月",
                "develop_end_date_year":null,
                "develop_end_date_month":null,
                "develop_summary":"ユーザー認証機能、お知らせ機能、FAQ機能、研修動画機能、および管理機能",
                "develop_env":"AWS, PHP, MySQL, Laravel, jQuery, HTML, CSS",
                "develop_role":"開発リーダー兼SE",
                "develop_scale":"プロジェクト人員：6名",
                "develop_url":null
            },
            "00000003-NRhhEAA":{
                "develop_name":"自社オフィシャルサイト開発",
                "develop_start_date_year":"2018年",
                "develop_start_date_month":"5月",
                "develop_end_date_year":"2018年",
                "develop_end_date_month":"8月",
                "develop_summary":"企業案内ページ、事業内容ページ、お知らせページ、採用情報ページ、多言語化、および管理機能",
                "develop_env":"AWS, PHP, Laravel, MySQL, jQuery, HTML, CSS",
                "develop_role":"開発リーダー兼SE",
                "develop_scale":"プロジェクト人員：5名",
                "develop_url":null
            }
        },
        "companies":{
            "00000001-KRRBSIc":{
                "company_name":"よろず株式会社",
                "company_start_date_year":"2018年",
                "company_start_date_month":"5月",
                "company_end_date_year":null,
                "company_end_date_month":null,
                "company_contract_type":"正社員"
            },
            "00000002-MXgAJpE":{
                "company_name":"株式会社ITルネッサンス",
                "company_start_date_year":"2014年",
                "company_start_date_month":"2月",
                "company_end_date_year":"2018年",
                "company_end_date_month":"5月",
                "company_contract_type":"正社員"
            }
        },
        "skills":{
            "00000001-QUcCBZI":{
                "skill_name":"PHP",
                "skill_experience":"10"
            },
            "00000002-GIBFBAQ":{
                "skill_name":"Javascript",
                "skill_experience":"10"
            }
        },
        "qualifications":{
            "00000002-NQYiVoE":{
                "qualification_name":"応用情報技術者試験",
                "qualification_at_year":"2018年",
                "qualification_at_month":"5月"
            },
            "00010003-QXQ2dJQ":{
                "qualification_name":"ITパスポート",
                "qualification_at_year":"2016年",
                "qualification_at_month":"7月"
            }
        }
    }
}