FrontPage

リクエストAPI/食品情報提供操作(開発用)

API情報

名称食品情報提供操作
APIバージョン2
認証タイプアプリケーションキーペア
URLhttps://(サーバー名)/requests/api2/(accode)/food/cbtest/
URLhttps://(サーバー名)/requests/api2/(accode)/food/cancel/
MethodPOST

概要

食品情報提供APIで登録したデータの操作を行う。本APIは開発用である。

使用方法

リクエストボディにJSONデータをセットして送信する。

リクエスト

JSONデータ書式

リクエスト本体
{
   'type' : (操作タイプ),
   'ver' : 1,
   'appkey' : (割り当てられたアプリケーションキー),
   'nonce' : (毎回異なる16バイト以上のランダムに生成されたASCII文字列),
   'secret' : (アプリケーションシークレット+nonceのSHA256値),
   'regid' : (結果オブジェクトに含まれていた登録結果ID)
 }
key必須項目内容
type必須タイプcbtest=コールバック発火/cancel=登録取消
ver必須バージョン固定値 1
appkey必須アプリケーションキーアクセスを識別する、割り当てられたアプリケーションキー
nonce必須ナンスランダム文字列。半角英数で構成し、16バイト以上、アクセス毎に異なること
secret必須認証文字列アプリケーションシークレット+nonceのSHA256値
regid必須登録結果ID結果オブジェクトに含まれていた登録結果ID

リクエスト例

{
    "type": "cbtest",
    "ver": 1,
    "appkey": "f37dX1DZdSAV3s9v",
    "nonce": "6b785fce3a643ec4",
    "secret": "ef7128c7001e63b1f89e3f9317b173dd567b0fead891e196127eef62c9f1fe19",
    "regid": "20230819154859-JVyL2OxHIhFcKX7fjOPIpf2UfEv0e7kP4FNgajAyLGxKDlRBf"
}

レスポンス

成功時、レスポンスコードは200を返す。 失敗時、レスポンスコードは400を返す。 レスポンスはjson形式である。

{
  'result' : true/false,
  'reason' : (resultがfalseの時: 失敗事由)
}

レスポンス例

{
    "result": true,
}

仕様変更履歴

2023/09/01 作成

このドキュメントのバージョン情報

Version2
Revision1
EditorIMD

トップ   差分 履歴 リロード   一覧 検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2023-10-01 (日) 00:05:22