APIサンプルコードの紹介

2024年7月2日2024年8月20日

現代のWebアプリケーションやモバイルアプリケーションにおいて、APIの利用は不可欠となっています。

API（Application Programming Interface）は、異なるソフトウェアシステム間で通信を行うための手段を提供します。

この記事では、代表的なAPIのサンプルコードをいくつか紹介し、その基本的な使い方を解説します。

RESTful APIの基本

RESTful APIは、HTTPプロトコルを利用してクライアントとサーバー間でデータをやりとりするAPIの一種です。

以下は、JavaScriptのfetch関数を使ってRESTful APIにリクエストを送信するサンプルコードです。

// データの取得（GETリクエスト）
fetch('https://api.example.com/data')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
  
// データの送信（POSTリクエスト）
fetch('https://api.example.com/data', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    key: 'value',
  }),
})
  .then(response => response.json())
  .then(data => console.log('Success:', data))
  .catch(error => console.error('Error:', error));

上記のコードでは、fetch関数を使ってGETとPOSTリクエストを行います。

GETリクエストでは、指定したURLからデータを取得し、コンソールに表示します。

POSTリクエストでは、JSON形式のデータを指定したURLに送信し、その結果をコンソールに表示します。

GraphQL APIの基本

GraphQLは、Facebookが開発したクエリ言語で、柔軟かつ効率的にデータを取得できます。

以下は、GraphQLを使ってデータを取得するサンプルコードです。

const query = `
  query {
    user(id: "1") {
      id
      name
      email
    }
  }
`;

fetch('https://api.example.com/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ query }),
})
  .then(response => response.json())
  .then(data => console.log('Success:', data))
  .catch(error => console.error('Error:', error));

このコードでは、GraphQLのクエリを指定し、それをサーバーに送信しています。

サーバーから返ってきたデータは、クエリに基づいて必要な情報だけを取得します。