Soracom

デバイスが Funk のエントリポイントに送信したデータは、Funk によって転送先のクラウドサービスに転送されます。

• Funk から送信されるデータフォーマットは、グループ設定の [送信データ形式] で指定できます。
• Funk から送信されるデータを、転送先のクラウドサービスで取得する方法については、クラウドサービスでデータを取得する を参照してください。

[送信データ形式] の設定について

Funk によって転送先のクラウドサービスに送信されるデータは、[送信データ形式] の設定によって異なります。

デバイスでのコマンド例:

$ curl -v funk.soracom.io \
-H "Content-Type: application/json" \
-d '{"hello": "funk"}' 

上記のコマンドを実行して Funk にデータを送信した場合に、転送先のクラウドサービスに送信されるデータは、以下のとおりです。

{'hello': 'funk'}

{'payload': '{"hello": "funk"}'}

{'payload': 'eyJoZWxsbyI6ICJmdW5rIn0='}

クラウドサービスでデータを取得する

データを受信したクラウドサービスでは、以下のようにデータを取得できます。

AWS Lambda

Python ランタイムの場合

Python ランタイムのハンドラーは、以下のとおりです。

def lambda_handler(event, context):
    return {
        'statusCode': 200,
        'body': json.dumps('Hello from Lambda!')
    }

• event: [送信データ形式] で指定したデータ形式に応じて値が設定されます。

• context (クライアントコンテキスト): 以下のフォーマットのデータが設定されます。Python ランタイムの場合は、Python の AWS Lambda context オブジェクト 内の client_context.custom に以下のような JSON を元にした dict が設定されます。

  例:

  {
    "custom": {
      "operatorId": "OPXXXXXXXXXX",
      "coverage": "global",
      "resourceType": "Subscriber",
      "resourceId": "2950XXXXXXXXXXX",
      "sourceProtocol": "http",
      "srn": "srn:soracom:OPXXXXXXXXXX:global:Subscriber:2950XXXXXXXXXXX",
      "imsi": "2950XXXXXXXXXXX",
      "simId": "8942XXXXXXXXXXXXXXX",
      "imei": "8676XXXXXXXXXXX"
    }
  }
  

Node.js ランタイムの場合

Node.js ランタイムのハンドラーは、以下のとおりです。

exports.handler = async (event, context) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify('Hello from Lambda!'),
    };
    return response;
};

• event: [送信データ形式] で指定したデータ形式に応じて値が設定されます。

• context (クライアントコンテキスト): 以下のフォーマットのデータが設定されます。Node.js ランタイムの場合は、Node.js の AWS Lambda context オブジェクト 内の clientContext に以下のような JSON が設定されます。

  {
    "operatorId": "OPXXXXXXXXXX",
    "coverage": "global",
    "resourceType": "Subscriber",
    "resourceId": "2950XXXXXXXXXXX",
    "sourceProtocol": "http",
    "srn": "srn:soracom:OPXXXXXXXXXX:global:Subscriber:2950XXXXXXXXXXX",
    "imsi": "2950XXXXXXXXXXX",
    "simId": "8942XXXXXXXXXXXXXXX",
    "imei": "8676XXXXXXXXXXX",
    "custom": {
      "operatorId": "OPXXXXXXXXXX",
      "coverage": "global",
      "resourceType": "Subscriber",
      "resourceId": "2950XXXXXXXXXXX",
      "sourceProtocol": "http",
      "srn": "srn:soracom:OPXXXXXXXXXX:global:Subscriber:2950XXXXXXXXXXX",
      "imsi": "2950XXXXXXXXXXX",
      "simId": "8942XXXXXXXXXXXXXXX",
      "imei": "8676XXXXXXXXXXX"
    }
  }
  

Azure Functions / Google Cloud Functions

以下のデータフォーマットが渡されます。

• method: 'POST' が指定されます。
• body: [送信データ形式] で指定したデータ形式に応じて値が設定されます。
• headers: user-agent には 'SORACOM Funk' が指定されます。content-type には 'application/json' が指定されます。x-soracom-token には JWT 形式のトークンが指定されます。