API

API Reference API Reference

API を使うと、API Labs. のインターフェイスから通常実行する機能を、ユーザーの Web サイトやアプリに統合できます。 APIs allow you to integrate functions normally performed from API Labs. interface into a user's website or apps.

コンテンツ Contents

API の呼び出し Calling the API

API の基本URLは以下のとおりです。 Base URL of the API is below.

        https://api.yuumari.com/apiName/
      

API の名前(apiName)は以下のとおりです。 Names of APIs (apiName) are below.

  • adfly (Bypasser for Adf.ly)
  • shst (Bypasser for Shorte.st)
  • adfocus (Bypasser for Adfoc.us)
  • bcvc (Bypasser for Bc.vc)
  • shortam (Bypasser for Short.am)
  • m-links (Bypasser for Some Specific AD-Links)
  • ouoio (Bypasser for Ouo.io)
  • exeio (Bypasser for Exe.io)
  • fclc (Bypasser for Fc.lc)
  • adshrinkit (Bypasser for Adshrink.it)
  • trlink (Bypasser for Tr.link)
  • shinkme (Bypasser for Shink.me)
  • 1bitspace (Bypasser for 1bit.space)

メソッドは POST のみです。(必要となるパラメータは以下のとおりです。) Method for access is POST only. (Required parameters are below.)

キー Key 詳細 Description 必要 Required
l 指定するURL (必ず http(s):// からはじまること) Target URL (must start with http(s)://) はい yes
u アクセスキー Access Key はい yes

バイパサー関連の有効なドメイン情報を得るには以下のURLを使用します。 For bypasser's effective domains is below.

        https://api.yuumari.com/apiName/domains/
      

メソッドは GET で、認証情報は必要としません。 Method for access is GET and no Access Key is required.

有効(もしくは無効)のドメイン情報を個別に得るには以下のURLを使用します。 For bypasser's Accept (or Drop) domains are below.

        https://api.yuumari.com/apiName/domains/accept/
      
        https://api.yuumari.com/apiName/domains/drop/
      

以下の要件が、API のリクエストに適用されます。

  • ドメイン情報の取得をのぞくリクエスト(POST メソッド)はすべて、認証鍵 を指定する必要があります。 All requests, except for getting domains info (POST Method), require Access Key.
  • すべてのリクエストはセキュア(https)環境下で行われます。 All connections are done in a secure environment (https).

API のレスポンス API Response

API のレスポンスは常に json 形式で配信されます。 APIs' response is always delivered in json format.

        Content-Type: application/json; charset=utf-8
      

実際のレスポンス情報は以下の内容です。 Response information is as follows.

        {
              "result": "<結果の情報が入ります><any results>"
              "message": "<何かのエラーの情報が入ります><any errors>"
        }
      


"result"


結果の情報がセットされます。(エラーが起きた場合、データはセットされません。) Result will be set. (If an error occurs, it will not be set.)

マルチバイト(Unicode)文字はエスケープ処理(\uXXXX)されます。 Multi-byte (Unicode) character will be escaped (\uXXXX).




"message"


エラーが起きた場合、エラーに関する簡易なメッセージがセットされます。(通常は空です。) If an error occurs, any simple message about it will be set. (Normally empty.)

対象のURLが 404 など、原因となるメッセージがここにセットされます。 Some cause of the target URL, such as 404, will be set here, not APIs' status code.).


API は常に 200 のHTTPステータスコードを返します。 APIs always return 200.

アクセスキー Access Key

API へのアクセスは認証鍵をパラメータに含めなければアクセスできません。 APIs; can only be accessed by specifing an Access Key as a parameter.

Javascript で呼び出す Javascript Coding

Javascript (UserScript) での開発につかえるかもしれません。 For Javascript (UserScript).

        !+function() {
          'use strict';
          const api = 'https://api.yuumari.com/apiName/';
          const u = 'Your KEY';
          const l = 'link';
          fetch(api, {
            method: 'POST',
            body: new URLSearchParams({u,l})
          }).then(r => r.json()).then(d => console.log(d));
        }();
      

とか Or

      !+function() {
        'use strict';
        const api = 'https://api.yuumari.com/apiName/';
        const u = 'Your KEY';
        const l = 'link';
        GM.xmlHttpRequest({
          method: 'POST',
          headers: {
            'Content-Type': 'application/x-www-form-urlencoded'
          },
          url: api,
          data: new URLSearchParams({u,l}).toString(),
          onload: r => {
            console.log(r.responseText);
          }
        });
      }();

      

とか Or

      !+function() {
        'use strict';
        const api = 'https://api.yuumari.com/apiName/';
        const u = 'Your KEY';
        const l = 'link';
        const xhr = new XMLHttpRequest();
        xhr.open('POST', api);
        xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
        xhr.onreadystatechange = () => {
          if (xhr.readyState === XMLHttpRequest.DONE && xhr.status === 200) {
            console.log(xhr.response);
          }
        }
        xhr.send(new URLSearchParams({u,l}).toString());
      }();