GrapeAvaterAPI リファレンス

GrapeAvatarAPI リファレンス

API説明と利用例

GrapeAvatarAPI を使用すると、APIキーを利用してファイルのアップロードおよび削除が可能です。 このAPIは、ユーザーからの大量アップロードを効率的に処理し、サーバーの容量やトラフィックの増大を気にすることなくファイル管理機能を提供します。

---

1. APIキーの取得

APIキーとフォルダー名を取得するには、メールでのお問い合わせが必要です。取得したAPIキーを使ってファイルのアップロードと削除を実行できます。

メール:[email protected]

---

2. ファイルアップロード

エンドポイント

POST https://grapes-avatarapi.mixeder.net/upload

使用例

cURL

curl -X POST https://grapes-avatarapi.mixeder.net/upload \
     -F "file=@/path/to/yourfile.png" \
     -F "apiKey=your_api_key"

Python

import requests

url = "https://grapes-avatarapi.mixeder.net/upload"
files = {"file": open("/path/to/yourfile.png", "rb")}
data = {"apiKey": "your_api_key"}

response = requests.post(url, files=files, data=data)
print(response.json())

PHP

<?php
$ch = curl_init("https://grapes-avatarapi.mixeder.net/upload");
$file = new CURLFile('/path/to/yourfile.png');
$data = ["file" => $file, "apiKey" => "your_api_key"];

curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

Node.js

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const form = new FormData();
form.append('file', fs.createReadStream('/path/to/yourfile.png'));
form.append('apiKey', 'your_api_key');

axios.post('https://grapes-avatarapi.mixeder.net/upload', form, { headers: form.getHeaders() })
  .then(response => { console.log(response.data); })
  .catch(error => { console.error(error); });

Go

package main

import (
    "fmt"
    "log"
    "mime/multipart"
    "net/http"
    "os"
)

func main() {
    file, err := os.Open("/path/to/yourfile.png")
    if err != nil {
        log.Fatal(err)
    }
    defer file.Close()

    body := &multipart.Writer{}
    req, err := http.NewRequest("POST", "https://grapes-avatarapi.mixeder.net/upload", body)
    req.Header.Set("Content-Type", body.FormDataContentType())

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()

    fmt.Println("アップロード結果:", resp.Status)
}

アップロード後、ファイルは次のURLからアクセスできます：

https://grapes-avatarapi.mixeder.net/フォルダ名/ファイル名

例：

{
  "message": "ファイルが正常に保存されました。",
  "fileName": "68fea2b2d25d1100.png"
}

---

3. ファイル削除

エンドポイント

DELETE https://grapes-avatarapi.mixeder.net/delete

使用例

cURL

curl -X DELETE https://grapes-avatarapi.mixeder.net/delete \
     -H "Content-Type: application/json" \
     -d '{"apiKey": "your_api_key", "fileName": "uploaded_file_name.png"}'

Python

import requests

url = "https://grapes-avatarapi.mixeder.net/delete"
payload = {"apiKey": "your_api_key", "fileName": "uploaded_file_name.png"}

response = requests.delete(url, json=payload)
print(response.json())

PHP

<?php
$ch = curl_init("https://grapes-avatarapi.mixeder.net/delete");
$data = json_encode(["apiKey" => "your_api_key", "fileName" => "uploaded_file_name.png"]);

curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

Node.js

const axios = require('axios');

const deleteData = { apiKey: "your_api_key", fileName: "uploaded_file_name.png" };

axios.delete('https://grapes-avatarapi.mixeder.net/delete', { data: deleteData })
  .then(response => { console.log(response.data); })
  .catch(error => { console.error(error); });

Ruby

require 'net/http'
require 'json'

uri = URI('https://grapes-avatarapi.mixeder.net/delete')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(uri.path, { 'Content-Type' => 'application/json' })
request.body = { apiKey: "your_api_key", fileName: "uploaded_file_name.png" }.to_json

response = http.request(request)
puts response.body

---

これらのコードを使用することで、ファイルのアップロードおよび削除が簡単に実行できます。APIキーを適切に管理し、安全なファイル操作を行いましょう。