Tokopedia

{
  "service_type": "platform",
  "base_url": "https://developer.tokopedia.com/openapi/",
  "auth_method": "oauth2",
  "auth_config": {
    "type": "oauth2",
    "grant_type": "authorization_code",
    "token_url": "https://accounts.tokopedia.com/token",
    "auth_url": "https://accounts.tokopedia.com/authorize",
    "scopes": ["public", "product", "order", "logistics", "finance", "notification", "promotion"],
    "additional_credentials": {
      "client_id": "provided by Tokopedia",
      "client_secret": "provided by Tokopedia",
      "access_token_validity": "Token expiration varies, refresh token required"
    }
  },
  "endpoints": [
    {
      "name": "Get Access Token",
      "method": "POST",
      "url": "https://accounts.tokopedia.com/token",
      "description": "Exchange authorization code for access and refresh tokens"
    },
    {
      "name": "Get Shop Info",
      "method": "GET",
      "url": "https://fs.tokopedia.com/info/fs",
      "description": "Retrieve shop and FS ID information. Requires Authorization header.",
      "parameters": ["Authorization: Bearer <access_token>"]
    },
    {
      "name": "Get Products List",
      "method": "GET",
      "url": "https://fs.tokopedia.com/inventory/v1/fs/{fs_id}/product/list",
      "description": "List products with pagination and filtering (e.g., status, search keyword)",
      "parameters": ["fs_id (integer)", "page (integer)", "per_page (integer)", "status", "search", "category_id", "sort_order"]
    },
    {
      "name": "Get Product Detail",
      "method": "GET",
      "url": "https://fs.tokopedia.com/inventory/v1/fs/{fs_id}/product/detail",
      "description": "Get detailed information for a specific product ID",
      "parameters": ["fs_id", "product_id", "shop_id (optional)"]
    },
    {
      "name": "Create Product",
      "method": "POST",
      "url": "https://fs.tokopedia.com/inventory/v1/fs/{fs_id}/product",
      "description": "Create a new product. Requires valid category and attributes.",
      "request_body": "JSON with product details (name, price, stock, weight, category_id, etc.)"
    },
    {
      "name": "Update Product",
      "method": "POST",
      "url": "https://fs.tokopedia.com/inventory/v1/fs/{fs_id}/product",
      "description": "Update existing product details (price, stock, etc.)",
      "request_body": "JSON with product_id and fields to update"
    },
    {
      "name": "Delete Product",
      "method": "DELETE",
      "url": "https://fs.tokopedia.com/inventory/v1/fs/{fs_id}/product",
      "description": "Deprecate or delete a product. Use 'delete' endpoint or status update.",
      "parameters": ["fs_id", "product_id"]
    },
    {
      "name": "Get Orders List",
      "method": "GET",
      "url": "https://fs.tokopedia.com/order/v2/order-list",
      "description": "Retrieve orders with filters (status, date range, search)",
      "parameters": ["fs_id", "status", "from_date", "to_date", "page", "per_page", "sort", "shop_id"]
    },
    {
      "name": "Get Order Detail",
      "method": "GET",
      "url": "https://fs.tokopedia.com/order/v2/order-detail",
      "description": "Get full order details including product items, shipping, and customer info",
      "parameters": ["fs_id", "order_id", "invoice_id"]
    },
    {
      "name": "Update Order Status",
      "method": "POST",
      "url": "https://fs.tokopedia.com/order/v2/fulfillment/status",
      "description": "Update order status (e.g., ship, deliver, cancel) and provide logistics details",
      "parameters": ["fs_id", "order_id", "status", "logistics_name", "tracking_number", "shipping_metadata"]
    },
    {
      "name": "Get Shipping Labels",
      "method": "POST",
      "url": "https://fs.tokopedia.com/order/v2/logistic/shipping-label",
      "description": "Generate shipping label PDF for an order",
      "request_body": "JSON with fs_id and order_id"
    },
    {
      "name": "Get Categories",
      "method": "GET",
      "url": "https://fs.tokopedia.com/inventory/v1/fs/{fs_id}/category/list",
      "description": "Retrieve list of product categories with IDs",
      "parameters": ["fs_id"]
    },
    {
      "name": "Get Category Meta Data",
      "method": "GET",
      "url": "https://fs.tokopedia.com/inventory/v1/fs/{fs_id}/category/detail",
      "description": "Get category attributes and rules for product creation",
      "parameters": ["fs_id", "category_id"]
    },
    {
      "name": "Update Stock",
      "method": "POST",
      "url": "https://fs.tokopedia.com/inventory/v1/fs/{fs_id}/stock",
      "description": "Update stock for product(s) - batch support",
      "request_body": "JSON with list of products: product_id and stock quantity"
    },
    {
      "name": "Update Price",
      "method": "POST",
      "url": "https://fs.tokopedia.com/inventory/v1/fs/{fs_id}/price",
      "description": "Update price for product(s) - batch",
      "request_body": "JSON with list of product_id and price"
    },
    {
      

3/3 tests passed

{
  "overall": 45,
  "dimensions": {
    "token_efficiency": 5.0,
    "first_try_success": 4.0,
    "response_parseability": 3.0,
    "error_clarity": 3.0,
    "doc_quality": 4.0,
    "auth_simplicity": 5.0,
    "latency": 5.6,
    "consistency": 6.0
  },
  "pricing_normalized": {},
  "issues": [
    "No specifics about platform capabilities or pricing model provided - unknown value proposition.",
    "robots.txt and llms.txt endpoints return HTML instead of expected structured files - not agent-friendly.",
    "Latency ranges 557-1356ms, borderline acceptable but not snappy.",
    "No security headers observed (though not critical for evaluation).",
    "Documentation and feature descriptions unavailable - cannot assess quality accurately.",
    "Error handling and limitations not documented clearly."
  ],
  "recommendations": [
    "Provide clear, concise description of what the platform does and its unique value for agents.",
    "Ensure robots.txt and llms.txt serve proper structured content (text/plain, JSON) to aid agent discovery.",
    "Optimize server response time to under 500ms for better agent experience.",
    "Publish detailed API documentation with clear error codes and rate limits.",
    "Add a status page and support for standard auth (OAuth/magic links) to simplify onboarding.",
    "Include pricing model transparently (free tier, credits, usage-based) to help agents recommend accurately."
  ]
}