Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

totp_verification_url in the task creation API and task cancel API documentation #605

Merged
merged 2 commits into from
Jul 15, 2024

Conversation

wintonzheng
Copy link
Contributor

@wintonzheng wintonzheng commented Jul 15, 2024

🚀 This description was created by Ellipsis for commit b5964a1

Summary:

Added documentation for totp_verification_url, TOTP endpoint setup, task cancellation API, and included a Python example for validating request signatures.

Key points:

  • Added totp_verification_url parameter to task creation API documentation in docs/running-tasks/api-spec.mdx.
  • Provided details on setting up a TOTP endpoint, including request and response formats, in docs/running-tasks/totp-verification-code.mdx.
  • Included Python example for validating request signatures in docs/running-tasks/totp-verification-code.mdx.
  • Documented the task cancellation API, including valid task states for cancellation and request type, in docs/running-tasks/api-spec.mdx.
  • Updated docs/mint.json to include the new TOTP documentation page.

Generated with ❤️ by ellipsis.dev

Copy link
Contributor

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Changes requested. Reviewed everything up to 3905e17 in 42 seconds

More details
  • Looked at 47 lines of code in 1 files
  • Skipped 0 files when reviewing.
  • Skipped posting 0 drafted comments based on config settings.

Workflow ID: wflow_LVHRFY2YCg7SCIL2


Want Ellipsis to fix these issues? Tag @ellipsis-dev in a comment. You can customize Ellipsis with 👍 / 👎 feedback, review rules, user-specific overrides, quiet mode, and more.


Response:
| Parameter | Type | Required? | Sample Value | Description |
| task_id | String | yes | tsk_123 | The task ID that needs the verification to be done |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The response table for the TOTP endpoint incorrectly lists task_id twice. It should only include verification_code as a response parameter.

Suggested change
| task_id | String | yes | tsk_123 | The task ID that needs the verification to be done |
| verification_code | String | no | 123456 | The verification code |

Copy link
Contributor

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Changes requested. Incremental review on b5964a1 in 59 seconds

More details
  • Looked at 91 lines of code in 3 files
  • Skipped 0 files when reviewing.
  • Skipped posting 0 drafted comments based on config settings.

Workflow ID: wflow_4ERuj6Dymu3wpQcL


Want Ellipsis to fix these issues? Tag @ellipsis-dev in a comment. You can customize Ellipsis with 👍 / 👎 feedback, review rules, user-specific overrides, quiet mode, and more.

Response:
| Parameter | Type | Required? | Sample Value | Description |
| task_id | String | yes | tsk_123 | The task ID that needs the verification to be done |
| verification_code | String | no | 123456 | The verification code |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The verification_code parameter in the response should be marked as required. Without a verification code, the TOTP process cannot be completed effectively.

Suggested change
| verification_code | String | no | 123456 | The verification code |
| verification_code | String | yes | 123456 | The verification code |

@wintonzheng wintonzheng merged commit 403b7d2 into main Jul 15, 2024
2 checks passed
@wintonzheng wintonzheng deleted the shu/API_doc_update branch July 15, 2024 19:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant