身份驗證

Rememberizer 提供幾個認證端點來管理用戶帳戶和會話。本文檔概述了可用的認證 API。

註冊

範例請求

cURL

curl -X POST \
  https://api.rememberizer.ai/api/v1/auth/signup/ \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[e-mail]",
    "password": "secure_password",
    "name": "John Doe",
    "captcha": "recaptcha_response"
  }'

將 recaptcha_response 替換為實際的 reCAPTCHA 回應。

JavaScript

const signUp = async () => {
  const response = await fetch('https://api.rememberizer.ai/api/v1/auth/signup/', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      email: '[e-mail]',
      password: 'secure_password',
      name: 'John Doe',
      captcha: 'recaptcha_response'
    })
  });
  
  const data = await response.json();
  console.log(data);
};

signUp();

將 recaptcha_response 替換為實際的 reCAPTCHA 回應。

Python

import requests
import json

def sign_up():
    headers = {
        "Content-Type": "application/json"
    }
    
    payload = {
        "email": "[e-mail]",
        "password": "secure_password",
        "name": "John Doe",
        "captcha": "recaptcha_response"
    }
    
    response = requests.post(
        "https://api.rememberizer.ai/api/v1/auth/signup/",
        headers=headers,
        data=json.dumps(payload)
    )
    
    data = response.json()
    print(data)

sign_up()

將 recaptcha_response 替換為實際的 reCAPTCHA 回應。

登入

範例請求

cURL

curl -X POST \
  https://api.rememberizer.ai/api/v1/auth/signin/ \
  -H "Content-Type: application/json" \
  -d '{
    "login": "[e-mail]",
    "password": "secure_password",
    "captcha": "recaptcha_response"
  }'

將 recaptcha_response 替換為實際的 reCAPTCHA 回應。

JavaScript

const signIn = async () => {
  const response = await fetch('https://api.rememberizer.ai/api/v1/auth/signin/', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      login: '[e-mail]',
      password: 'secure_password',
      captcha: 'recaptcha_response'
    })
  });
  
  // 檢查回應中的身份驗證 cookie
  if (response.status === 204) {
    console.log("登入成功！");
  } else {
    console.error("登入失敗！");
  }
};

signIn();

將 recaptcha_response 替換為實際的 reCAPTCHA 回應。

Python

import requests
import json

def sign_in():
    headers = {
        "Content-Type": "application/json"
    }
    
    payload = {
        "login": "[e-mail]",
        "password": "secure_password",
        "captcha": "recaptcha_response"
    }
    
    response = requests.post(
        "https://api.rememberizer.ai/api/v1/auth/signin/",
        headers=headers,
        data=json.dumps(payload)
    )
    
    if response.status_code == 204:
        print("登入成功！")
    else:
        print("登入失敗！")

sign_in()

將 recaptcha_response 替換為實際的 reCAPTCHA 回應。

電子郵件驗證

範例請求

cURL

curl -X POST \
  https://api.rememberizer.ai/api/v1/auth/verify-email/ \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "verification_code": "123456"
  }'

將 YOUR_JWT_TOKEN 替換為您的實際 JWT 令牌，並使用發送到您電子郵件的驗證碼。

JavaScript

const verifyEmail = async () => {
  const response = await fetch('https://api.rememberizer.ai/api/v1/auth/verify-email/', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_JWT_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      verification_code: '123456'
    })
  });
  
  if (response.status === 200) {
    console.log("電子郵件驗證成功！");
  } else {
    console.error("電子郵件驗證失敗！");
  }
};

verifyEmail();

將 YOUR_JWT_TOKEN 替換為您的實際 JWT 令牌，並使用發送到您電子郵件的驗證碼。

Python

import requests
import json

def verify_email():
    headers = {
        "Authorization": "Bearer YOUR_JWT_TOKEN",
        "Content-Type": "application/json"
    }
    
    payload = {
        "verification_code": "123456"
    }
    
    response = requests.post(
        "https://api.rememberizer.ai/api/v1/auth/verify-email/",
        headers=headers,
        data=json.dumps(payload)
    )
    
    if response.status_code == 200:
        print("電子郵件驗證成功！")
    else:
        print("電子郵件驗證失敗！")

verify_email()

將 YOUR_JWT_TOKEN 替換為您的實際 JWT 令牌，並使用發送到您電子郵件的驗證碼。

令牌管理

示例請求

cURL

curl -X POST \
  https://api.rememberizer.ai/api/v1/auth/custom-refresh/ \
  -b "refresh_token=YOUR_REFRESH_TOKEN"

此端點使用 cookies 進行身份驗證。刷新令牌應作為 cookie 發送。

JavaScript

const refreshToken = async () => {
  const response = await fetch('https://api.rememberizer.ai/api/v1/auth/custom-refresh/', {
    method: 'POST',
    credentials: 'include' // 這會在請求中包含 cookies
  });
  
  if (response.status === 204) {
    console.log("令牌成功刷新！");
  } else {
    console.error("令牌刷新失敗！");
  }
};

refreshToken();

此端點使用 cookies 進行身份驗證。確保您的應用程序在請求中包含憑據。

Python

import requests

def refresh_token():
    cookies = {
        "refresh_token": "YOUR_REFRESH_TOKEN"
    }
    
    response = requests.post(
        "https://api.rememberizer.ai/api/v1/auth/custom-refresh/",
        cookies=cookies
    )
    
    if response.status_code == 204:
        print("令牌成功刷新！")
    else:
        print("令牌刷新失敗！")

refresh_token()

將 YOUR_REFRESH_TOKEN 替換為您的實際刷新令牌。

登出

範例請求

curl -X POST \
  https://api.rememberizer.ai/api/v1/auth/custom-logout/

此端點將清除身份驗證 cookie。

const logout = async () => {
  const response = await fetch('https://api.rememberizer.ai/api/v1/auth/custom-logout/', {
    method: 'POST',
    credentials: 'include' // 這會在請求中包含 cookie
  });
  
  if (response.status === 204) {
    console.log("登出成功！");
  } else {
    console.error("登出失敗！");
  }
};

logout();

此端點使用 cookie 進行身份驗證。請確保您的應用程序在請求中包含憑證。

import requests

def logout():
    session = requests.Session()
    
    response = session.post(
        "https://api.rememberizer.ai/api/v1/auth/custom-logout/"
    )
    
    if response.status_code == 204:
        print("登出成功！")
    else:
        print("登出失敗！")

logout()

此端點將清除身份驗證 cookie。

{% endtabs %