Аутентификация

Обзор

У каждой учётной записи Crawlbase есть два токена, которые создаются автоматически при регистрации. Оба аутентифицируют одну и ту же учётную запись и используют общую квоту - они лишь направляют запросы через разную инфраструктуру.

Как пройти аутентификацию

Передавайте ваш токен в виде query-параметра token в каждом запросе. Это вся схема аутентификации.

curl 'https://api.crawlbase.com/?token=YOUR_TOKEN&url=https%3A%2F%2Fexample.com'

from crawlbase import CrawlingAPI

# Pass your token at construction; reuse the client across requests
api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get('https://example.com')

const { CrawlingAPI } = require('crawlbase');

const api = new CrawlingAPI({ token: process.env.CRAWLBASE_TOKEN });
const res = await api.get('https://example.com');

require 'crawlbase'

api = Crawlbase::API.new(token: ENV['CRAWLBASE_TOKEN'])
res = api.get('https://example.com')

 getenv('CRAWLBASE_TOKEN')]);
$res = $api->get('https://example.com');

package main

import (
    "os"
    "github.com/crawlbase/crawlbase-go"
)

func main() {
    api := crawlbase.NewCrawlingAPI(os.Getenv("CRAWLBASE_TOKEN"))
    res, _ := api.Get("https://example.com")
    _ = res
}

Выбор подходящего токена

Краткое дерево решений:

Если не уверены, сначала попробуйте Normal. Если в ответе нет контента, который вы видите в браузере, переключитесь на JavaScript.

Безопасность и ротация

Относитесь к токенам как к паролям. Не коммитьте их в систему контроля версий, не вставляйте в тикеты поддержки и меняйте их при подозрении на утечку.

• Используйте переменные окружения: никогда не зашивайте токены в исходный код.
• Выполняйте ротацию через панель управления: кнопка «Reset token» генерирует новое значение и немедленно делает старое недействительным.
• Один token на окружение: держите разработку и продакшен на разных учётных записях, чтобы утечка в одной не отравила другую.
• Никогда не раскрывайте токены на стороне клиента: вызовы Crawlbase должны исходить из вашего бэкенда. Token в браузерном JavaScript - это token в руках у всех.

Ошибки, связанные с аутентификацией

Если с вашим токеном что-то не так, вы получите один из следующих ответов:

Полный список кодов статуса см. в разделе Status Codes.

Дальнейшие шаги